- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- CustomerAssetSetOperation
- МутатеКустомерАссетсетрезультат
- Попробуй это!
Создает или удаляет наборы активов клиентов. Статусы операций возвращаются.
HTTP-запрос
POST https://googleads.googleapis.com/v14/customers/{customerId}/customerAssetSets:mutate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, наборы активов клиента которого изменяются. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "operations": [ { object ( |
Поля | |
---|---|
operations[] | Необходимый. Список операций, которые необходимо выполнить с отдельными наборами активов клиента. |
partialFailure | Если это правда, будут выполнены успешные операции, а недопустимые операции вернут ошибки. Если false, все операции будут выполняться за одну транзакцию тогда и только тогда, когда все они действительны. По умолчанию — ложь. |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
responseContentType | Настройка типа контента ответа. Определяет, должен ли быть возвращен после мутации изменяемый ресурс или только имя ресурса. |
Тело ответа
Ответное сообщение для изменения набора активов клиента.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "results": [ { object ( |
Поля | |
---|---|
results[] | Все результаты для mutate. |
partialFailureError | Ошибки, относящиеся к сбоям работы в режиме частичного отказа. Возвращается только в том случае, если partialFailure = true и все ошибки происходят внутри операций. Если какие-либо ошибки происходят вне операций (например, ошибки аутентификации), мы возвращаем ошибку уровня RPC. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
CustomerAssetSetOperation
Одна операция (создание, удаление) с набором активов клиента.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
Полевая operation Союза. Операция мутации. operation может быть только одной из следующих: | |
create | Операция создания: для нового набора активов клиента не ожидается имя ресурса. |
remove | Операция удаления: ожидается имя ресурса для удаленного набора активов клиента в следующем формате: |
МутатеКустомерАссетсетрезультат
Результат изменения набора активов клиента.
JSON-представление |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Поля | |
---|---|
resourceName | Вернулся для успешных операций. |
customerAssetSet | Мутировавший набор активов клиента, содержащий только изменяемые поля после мутации. Поле будет возвращено только в том случае, если для параметра responseContentType установлено значение «MUTABLE_RESOURCE». |