Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Возможность массового редактирования параметров таргетинга для нескольких групп объявлений.

Один и тот же набор запросов на удаление и создание будет применен ко всем указанным группам объявлений. В частности, операция удалит назначенные параметры таргетинга, указанные в BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests , из каждой группы объявлений, а затем создаст назначенные параметры таргетинга, указанные в BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests .

Этот метод поддерживается только для групп объявлений, генерируемых по запросу.

HTTP-запрос

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

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

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

Параметры
advertiserId

string ( int64 format)

Обязательно. Идентификатор рекламодателя, к которому относятся группы объявлений.

Текст запроса

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

JSON-представление 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Поля
adGroupIds[]

string ( int64 format)

Обязательно. Идентификаторы групп объявлений, к которым будут принадлежать назначенные параметры таргетинга. Можно указать максимум 25 идентификаторов групп объявлений.

deleteRequests[]

object ( DeleteAssignedTargetingOptionsRequest )

Необязательно. Назначенные параметры целевого назначения для пакетного удаления, указанные в виде списка DeleteAssignedTargetingOptionsRequest .

Поддерживаемые типы таргетинга:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object ( CreateAssignedTargetingOptionsRequest )

Необязательно. Назначенные параметры таргетинга для пакетного создания, указанные в виде списка CreateAssignedTargetingOptionRequest .

Поддерживаемые типы таргетинга:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Ответный текст

Ответное сообщение для adGroups.bulkEditAssignedTargetingOptions .

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

JSON-представление 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Поля
updatedAdGroupIds[]

string ( int64 format)

Только вывод. Идентификаторы групп объявлений, которые были успешно обновлены.

failedAdGroupIds[]

string ( int64 format)

Только вывод. Идентификаторы групп объявлений, которые не удалось обновить.

errors[]

object ( Status )

Только вывод. Информация об ошибках для каждой группы объявлений, обновление которой не удалось.

Области полномочий

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

  • https://www.googleapis.com/auth/display-video

Для получения более подробной информации см.OAuth 2.0 Overview .