Method: advertisers.audit

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

HTTP-запрос

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

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

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

Параметры
advertiser Id

string ( int64 format)

Необходимый. Идентификатор рекламодателя, который необходимо проверить.

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

Параметры
read Mask

string ( FieldMask format)

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

  • использованноелинейтемскунт
  • использованныйInsertionOrdersCount
  • использованоCampaignsCount
  • каналыКоличество
  • отрицательноTargetedChannelsCount
  • отрицательный ключевое словоListsCount
  • adGroupCriteriaCount
  • кампанияCriteriaCount

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

Тело запроса

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

Тело ответа

Ответное сообщение для AdvertiserService.AuditAdvertiser.

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

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

string ( int64 format)

Количество АКТИВНЫХ, ПАУЗИРОВАННЫХ и ПРОЕКТНЫХ позиций этого рекламодателя. Эти позиции учитываются при расчете лимита в 9999 позиций на одного рекламодателя.

used Insertion Orders Count

string ( int64 format)

Количество АКТИВНЫХ, ПАУЗИРОВАННЫХ и ПРОЕКТОВ заказов на размещение под этим рекламодателем. Эти заказы на размещение учитываются при расчете лимита в 9999 заказов на размещение на одного рекламодателя.

used Campaigns Count

string ( int64 format)

Количество АКТИВНЫХ и ПРИОСТАНОВЛЕННЫХ кампаний этого рекламодателя. Эти кампании учитываются при расчете лимита в 9999 кампаний на одного рекламодателя.

channels Count

string ( int64 format)

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

negatively Targeted Channels Count

string ( int64 format)

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

negative Keyword Lists Count

string ( int64 format)

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

ad Group Criteria Count

string ( int64 format)

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

Соответствующие типы таргетинга:

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

string ( int64 format)

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

Соответствующие типы таргетинга:

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

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

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

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

Дополнительную информацию см. в обзоре OAuth 2.0 .