- HTTP リクエスト
- パスパラメータ
- リクエストの本文
- レスポンスの本文
- 認可スコープ
- AccountBudgetProposalOperation
- MutateAccountBudgetProposalResult
- 試してみる
アカウントの予算の提案を作成、更新、削除します。オペレーションのステータスが返されます。
スローされるエラーのリスト: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestErrorStringLengthError
HTTP リクエスト
POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
必須。顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"operation": {
object ( |
フィールド | |
---|---|
operation |
必須。個々のアカウント単位の予算提案で実行するオペレーションです。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。 |
レスポンスの本文
アカウント単位の予算変換オペレーションに対するレスポンス メッセージです。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"result": {
object ( |
フィールド | |
---|---|
result |
変換の結果。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。
AccountBudgetProposalOperation
1 回の操作で、アカウント単位の新しい予算の作成、既存の予算の編集、終了、削除を提案できます。
JSON 表現 |
---|
{ "updateMask": string, // Union field |
フィールド | |
---|---|
updateMask |
変更する予算フィールドを決定する FieldMask。予算は変更される可能性がありますが、そのような変更を提案する提案は最終的なものです。そのため、プロポーザルでは更新操作はサポートされていません。 予算を変更するプロポーザルの場合、プロポーザル タイプは「更新」です。他のプロポーザル タイプでマスクを指定するとエラーになります。 完全修飾フィールド名のカンマ区切りリストです。(例: |
共用体フィールド operation 。mute オペレーションです。operation は次のいずれかになります。 |
|
create |
作成オペレーション: 新しい予算の作成、既存の予算の編集、運用中の予算の終了、または開始日が予定されている承認済みの予算の削除を行うための新しい提案です。新しい提案にリソース名は不要です。 |
remove |
削除操作: 削除された提案のリソース名は次の形式で指定します。
|
MutateAccountBudgetProposalResult
アカウントの予算提案の結果が変わります。
JSON 表現 |
---|
{ "resourceName": string } |
フィールド | |
---|---|
resourceName |
成功したオペレーションに対して返されます。 |