注意: API の REST インターフェースに関するドキュメントを表示しています。当社の公式クライアントライブラリのほとんどは gRPC を使用しています。詳しくは、REST の概要をご覧ください。

このページは Cloud Translation API によって翻訳されました。

BillingSetup

JSON 表現
BillingSetupStatus
PaymentsAccountInfo
- JSON 表現

お支払い情報の設定。お支払いアカウントと広告主を関連付けるものです。お支払い情報の設定は、1 人の広告主様に対してのみ行います。

JSON 表現

JSON 表現
{ "resourceName": string, "status": enum (`BillingSetupStatus`), "paymentsAccountInfo": { object (`PaymentsAccountInfo`) }, "id": string, "paymentsAccount": string, // Union field `start_time` can be only one of the following: "startDateTime": string, "startTimeType": enum (`TimeType`) // End of list of possible types for union field `start_time`. // Union field `end_time` can be only one of the following: "endDateTime": string, "endTimeType": enum (`TimeType`) // End of list of possible types for union field `end_time`. }

{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}

フィールド
`resourceName`	`string` 変更不可。お支払い情報設定のリソース名。BillingSetup リソース名の形式は次のとおりです。 `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum (BillingSetupStatus)` 出力のみ。お支払い情報の設定のステータス。
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` 変更不可。このお支払い情報の設定に関連付けられているお支払いアカウント情報。お支払い情報の設定時に、新しいお支払いアカウントで登録するために使用されます（その後は paymentsAccount は設定しないでください）。お支払い情報の設定時に、このアカウントと paymentsAccount に値が入力されます。
`id`	`string (int64 format)` 出力のみ。お支払い情報設定の ID。
`paymentsAccount`	`string` 変更不可。このお支払い情報の設定に関連付けられているお支払いアカウントのリソース名。Payments リソース名の形式は次のとおりです。 `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` お支払い情報の設定時に、既存のお支払いアカウントで登録するために使用されます（その後は paymentsAccountInfo は設定できません）。お支払い情報の設定時に、この要素と paymentsAccountInfo が入力されます。
共用体フィールド `start_time`。新しいお支払い情報の設定を作成すると、この設定が有効になります。[NOW] のみが、承認されている設定がない場合に認められます。既存のお支払い情報の設定を取得する場合、リクエストされた開始時間です。ただし、リクエストされた開始時間の後に設定が承認された場合（ステータスを参照）は、承認時間になります。`start_time` は次のいずれかになります。
`startDateTime`	`string` 変更不可。yyyy-MM-dd または yyyy-MM-dd HH:mm:ss 形式の開始日時。未来の時刻のみ指定できます。
`startTimeType`	`enum (TimeType)` 変更不可。タイプとしての開始時間。NOW のみが許可されます。
共用体フィールド `end_time`。お支払い情報の設定が終了または終了したとき。これは、FOREVER、または次回のお支払い情報の設定の開始時刻です。`end_time` は次のいずれかになります。
`endDateTime`	`string` 出力のみ。yyyy-MM-dd または yyyy-MM-dd HH:mm:ss 形式の終了日時。
`endTimeType`	`enum (TimeType)` 出力のみ。タイプとしての終了時間。指定可能な値は FOREVER のみです。

BillingSetupStatus

BillingSetup のステータス。

列挙型
`UNSPECIFIED`	指定されていません。
`UNKNOWN`	戻り値にのみ使用されます。このバージョンで不明な値を表します。
`PENDING`	お支払い情報の設定は承認待ちです。
`APPROVED_HELD`	お支払い情報の設定は承認されていますが、対応する最初の予算が承認されていません。これは、毎月の請求書発行に設定されているお支払い情報の設定に対してのみ発生する可能性があります。
`APPROVED`	お支払い情報の設定は承認されています。
`CANCELLED`	お支払い情報の設定は、承認前にユーザーによってキャンセルされました。

PaymentsAccountInfo

この請求の支払いアカウント情報のコンテナ。

JSON 表現
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string }

フィールド
`paymentsAccountId`	`string` 出力のみ。お支払い情報の設定に関連付けられたお支払いアカウントの識別に使用される 16 桁の ID。「1234-5678-9012-3456」のように、ダッシュを含む文字列として渡す必要があります。
`paymentsAccountName`	`string` 変更不可。お支払い情報の設定に関連付けられているお支払いアカウントの名前。これにより、毎月の請求書を照合しやすくなるよう、お支払いアカウントにわかりやすい名前を指定できます。この名前は毎月の請求書に印刷されます。
`paymentsProfileId`	`string` 変更不可。お支払い情報の設定に関連付けられたお支払いプロファイルの識別に使用される 12 桁の ID。「1234-5678-9012」のように、ダッシュを含む文字列として渡す必要があります。
`paymentsProfileName`	`string` 出力のみ。お支払い情報の設定に関連付けられているお支払いプロファイルの名前。
`secondaryPaymentsProfileId`	`string` 出力のみ。予備のお支払いプロファイル ID は、シーケンシャルライアビリティ契約を結んだ場合など、一般的でない状況で使用されます。