Method: advertisers.audit

Проверяет рекламодателя. Возвращает количество используемых объектов по типу ресурса для указанного рекламодателя. Используемые объекты учитываются в лимитах на ресурсы. Подробнее: https://support.google.com/displayvideo/answer/6071450.

HTTP-запрос

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}:audit

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

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

Параметры
advertiserId

string (int64 format)

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

Параметры запроса

Параметры
readMask

string (FieldMask format)

Необязательное поле. Поля, которые нужно вернуть. Если маска не указана, будут заполнены все поля в ответе. Допустимые значения:

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

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

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответ на запрос AdvertiserService.AuditAdvertiser.

Ниже приведена структура данных в ответе, полученном на запрос.

JSON-представление 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Поля
usedLineItemsCount

string (int64 format)

Количество позиций со статусом "Активно", "Приостановлено" и "Черновик" у этого рекламодателя. Эти позиции учитываются при подсчете лимита в 9999 позиций на рекламодателя.
usedInsertionOrdersCount

string (int64 format)

Количество активных, приостановленных и черновых заказов на размещение, относящихся к этому рекламодателю. Эти заказы на размещение учитываются в ограничении на количество заказов на размещение у одного рекламодателя (9999).
usedCampaignsCount

string (int64 format)

Количество активных и приостановленных кампаний этого рекламодателя. Эти кампании учитываются в ограничении на количество кампаний у рекламодателя (9999).
channelsCount

string (int64 format)

Количество каналов, созданных для этого рекламодателя. Эти каналы учитываются в ограничении на 1000 каналов на рекламодателя.
negativelyTargetedChannelsCount

string (int64 format)

Количество каналов, для которых настроен минус-таргетинг на уровне рекламодателя. Эти каналы учитываются в ограничении на количество каналов с минус-таргетингом (не более пяти на рекламодателя).
negativeKeywordListsCount

string (int64 format)

Количество списков минус-слов, созданных для этого рекламодателя. Эти списки минус-слов учитываются в ограничении на количество списков минус-слов на рекламодателя (не более 20).
adGroupCriteriaCount

string (int64 format)

Количество отдельных настроек таргетинга, относящихся к перечисленным ниже типам таргетинга и назначенных позиции, которая относится к этому рекламодателю. Эти отдельные настройки таргетинга учитываются в ограничении на 4 500 000 настроек таргетинга на уровне группы объявлений для одного рекламодателя.

Допустимые типы таргетинга:

  • Каналы, URL, приложения и подборки
  • Демографические характеристики
  • Сегменты аудитории Google, в том числе аудитории по интересам, особые аудитории по интересам и аудитории заинтересованных покупателей
  • Источник инвентаря
  • Ключевое слово
  • Категория мобильных приложений
  • Списки пользователей
  • Таргетинг видеорекламы
  • Видимость
campaignCriteriaCount

string (int64 format)

Количество отдельных настроек таргетинга, относящихся к перечисленным ниже типам таргетинга и назначенных позиции, которая относится к этому рекламодателю. Эти отдельные варианты таргетинга учитываются в ограничении на 900 000 вариантов таргетинга кампании на рекламодателя.

Допустимые типы таргетинга:

  • Позиция
  • Браузер
  • Скорость подключения
  • Дата и время
  • Устройство и операционную систему
  • Ярлык цифрового контента
  • Деликатные категории
  • Среда
  • География, в том числе сетевой бизнес и близость
  • ISP
  • Язык
  • Как пройти проверку через сторонний сервис

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

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

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

Дополнительную информацию вы найдете в OAuth 2.0 Overview.