Method: customers.accountBudgetProposals.mutate

Создает, обновляет или удаляет предложения по бюджету аккаунта. Статусы операций возвращаются.

Список выброшенных ошибок: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError StringLengthError

HTTP-запрос

POST https://googleads.googleapis.com/v14/customers/{customerId}/accountBudgetProposals:mutate

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор клиента.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Поля
operation

object ( AccountBudgetProposalOperation )

Необходимый. Операция, выполняемая над предложением бюджета на уровне отдельного аккаунта.

validateOnly

boolean

Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты.

Тело ответа

Ответное сообщение для операций изменения бюджета на уровне аккаунта.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Поля
result

object ( MutateAccountBudgetProposalResult )

Результат мутации.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/adwords

Дополнительную информацию см. в обзоре OAuth 2.0 .

СчетБюджетПредложениеОперация

Одна операция, позволяющая предложить создание нового бюджета на уровне аккаунта или изменить/завершить/удалить существующий.

JSON-представление
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Поля
updateMask

string ( FieldMask format)

FieldMask, определяющая, какие поля бюджета изменяются. Хотя бюджеты могут быть изменены, предложения, предлагающие такие изменения, являются окончательными. Таким образом, операции обновления не поддерживаются для предложений.

Предложения, изменяющие бюджеты, имеют тип предложения «обновление». Указание маски для любого другого типа предложения считается ошибкой.

Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" .

Полевая operation Союза. Операция мутации. operation может быть только одной из следующих:
create

object ( AccountBudgetProposal )

Операция создания: новое предложение по созданию нового бюджета, редактированию существующего бюджета, прекращению активного бюджета или удалению утвержденного бюджета, запуск которого запланирован на будущее. Для нового предложения не ожидается имя ресурса.

remove

string

Операция удаления. Ожидается имя ресурса для удаленного предложения в следующем формате:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Запрос может быть отменен, если он находится на рассмотрении.

MutateAccountBudgetProposalResult

Результат предложения по бюджету аккаунта изменился.

JSON-представление
{
  "resourceName": string
}
Поля
resourceName

string

Вернулся для успешных операций.