Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

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

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

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

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

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

Параметры
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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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_CATEGORY
  • TARGETING_TYPE_COMBINED_AUDIENCE
  • TARGETING_TYPE_CUSTOM_LIST
  • TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_GOOGLE_AUDIENCE
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_LOOKALIKE_AUDIENCE
  • 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.