お支払い情報の設定。お支払いアカウントと広告主を関連付けるものです。お支払い情報の設定は、1 社の広告主様に固有のものです。
JSON 表現 |
---|
{ "resourceName": string, "status": enum ( |
フィールド | |
---|---|
resourceName |
変更不可。お支払い情報の設定のリソース名。BillingSetup リソース名の形式は次のとおりです。
|
status |
出力のみ。お支払い情報の設定のステータス。 |
paymentsAccountInfo |
変更不可。このお支払い情報の設定に関連付けられているお支払いアカウントの情報。お支払い情報の設定時に、新しいお支払いアカウントの登録に使用されます(その後、paymentsAccount は設定しないでください)。お支払い情報の設定時に、このフィールドと paymentsAccount が入力されます。 |
id |
出力のみ。お支払い情報の設定の ID。 |
paymentsAccount |
変更不可。このお支払い情報の設定に関連付けられているお支払いアカウントのリソース名。Payments リソース名の形式は次のとおりです。
|
共用体フィールド 既存のお支払い情報を取得するときにリクエストされた開始時間。リクエストされた開始時間より後に設定が承認された場合(ステータスを参照)は、承認時間です。 |
|
startDateTime |
変更不可。開始日の日時は、yyyy-MM-dd または yyyy-MM-dd HH:mm:ss 形式で指定します。指定できるのは将来の時刻のみです。 |
startTimeType |
変更不可。開始時刻を型で指定します。使えるのは NOW のみです。 |
共用体フィールド end_time 。お支払い情報の設定が終了または終了した場合。これは、永久、または次回のお支払い情報の設定が予定されている開始時刻のいずれかです。end_time は次のいずれかになります。 |
|
endDateTime |
出力のみ。終了日の時刻を yyyy-MM-dd または yyyy-MM-dd HH:mm:ss 形式で指定します。 |
endTimeType |
出力のみ。終了時刻を型で指定します。指定可能な値は FOREVER のみです。 |
BillingSetupStatus
BillingSetup のステータス。
列挙型 | |
---|---|
UNSPECIFIED |
指定されていません。 |
UNKNOWN |
戻り値にのみ使用されます。このバージョンで不明な値を表します。 |
PENDING |
お支払い情報の設定は承認待ちの状態です。 |
APPROVED_HELD |
お支払い情報の設定は承認されていますが、対応する最初の予算が承認されていません。これは、毎月の請求書発行に設定されているお支払い情報の設定に対してのみ発生する可能性があります。 |
APPROVED |
お支払い情報の設定は承認されています。 |
CANCELLED |
お支払い情報の設定は、承認前にユーザーによってキャンセルされました。 |
PaymentsAccountInfo
この請求のお支払いアカウント情報のコンテナ。
JSON 表現 |
---|
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string } |
フィールド | |
---|---|
paymentsAccountId |
出力のみ。お支払い情報の設定に関連付けられたお支払いアカウントの識別に使用される 16 桁の ID。 ダッシュを含む文字列として渡す必要があります(例: 「1234-5678-9012-3456」)。 |
paymentsAccountName |
変更不可。お支払い情報の設定に関連付けられているお支払いアカウントの名前。 これにより、毎月の請求書を調整するのに役立つお支払いアカウントにわかりやすい名前を指定できるようになります。 この名前は毎月の請求書に印刷されます。 |
paymentsProfileId |
変更不可。お支払い情報の設定に関連付けられたお支払いプロファイルを識別するために使用される 12 桁の ID。 ダッシュを含む文字列として渡す必要があります(例: 1234-5678-9012)。 |
paymentsProfileName |
出力のみ。お支払い情報の設定に関連付けられているお支払いプロファイルの名前。 |
secondaryPaymentsProfileId |
出力のみ。予備のお支払いプロファイル ID は、シーケンシャル ライアビリティ契約を締結した場合など、一般的でない状況で表示されます。 |