- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- CustomAudienceOperation
- MutateCustomAudienceResult
- Попробуй это!
Создает или обновляет пользовательские аудитории. Статусы операций возвращаются.
Список выброшенных ошибок: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}/customAudiences:mutate
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, чьи пользовательские аудитории изменяются. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{
"operations": [
{
object ( |
Поля | |
---|---|
operations[] | Необходимый. Список операций, которые необходимо выполнить с отдельными пользовательскими аудиториями. |
validateOnly | Если это правда, запрос проверяется, но не выполняется. Возвращаются только ошибки, а не результаты. |
Тело ответа
Ответное сообщение для изменения пользовательской аудитории.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"results": [
{
object ( |
Поля | |
---|---|
results[] | Все результаты для mutate. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
CustomAudienceOperation
Одна операция (создание, обновление) для индивидуальной аудитории.
JSON-представление |
---|
{ "updateMask": string, // Union field |
Поля | |
---|---|
updateMask | FieldMask, определяющая, какие поля ресурсов изменяются при обновлении. Это разделенный запятыми список полных имен полей. Пример: |
Полевая operation Союза. Операция мутации. operation может быть только одной из следующих: | |
create | Операция создания: для новой пользовательской аудитории не ожидается имя ресурса. |
update | Операция обновления: ожидается, что пользовательская аудитория будет иметь допустимое имя ресурса. |
remove | Операция удаления: ожидается имя ресурса для удаленной пользовательской аудитории в следующем формате: |
MutateCustomAudienceResult
Результат изменения пользовательской аудитории.
JSON-представление |
---|
{ "resourceName": string } |
Поля | |
---|---|
resourceName | Вернулся для успешных операций. |