Method: customers.accountLinks.mutate

Создает или удаляет ссылку на учетную запись. В версии V5 создание не поддерживается через AccountLinkService.MutateAccountLink. Вместо этого используйте AccountLinkService.CreateAccountLink.

Список выброшенных ошибок: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

HTTP-запрос

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

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

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

Параметры
customerId

string

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

Тело запроса

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

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

object ( AccountLinkOperation )

Необходимый. Операция, выполняемая над ссылкой.

partialFailure

boolean

Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. По умолчанию — ложь.

validateOnly

boolean

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

Тело ответа

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

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

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

object ( MutateAccountLinkResult )

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

partialFailureError

object ( Status )

Ошибки, относящиеся к сбоям работы в режиме частичного отказа. Возвращается только в том случае, если partialFailure = true и все ошибки происходят внутри операций. Если возникают какие-либо ошибки вне операций (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC.

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

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

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

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

АккаунтСсылкаОперация

Одно обновление по ссылке на аккаунт.

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

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

string ( FieldMask format)

FieldMask, определяющая, какие поля ресурсов изменяются при обновлении.

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

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

object ( AccountLink )

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

remove

string

Операция удаления: ожидается имя ресурса для удаляемой ссылки учетной записи в следующем формате:

customers/{customerId}/accountLinks/{accountLinkId}

Мутатеаккаунтлинкрезультат

Результат изменения ссылки на аккаунт.

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

string

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