Method: advertisers.audit

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

HTTP-запрос

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

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

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

Параметры
advertiserId

string ( int64 format)

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

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

Параметры
readMask

string ( FieldMask format)

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

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • каналовКоличество
  • 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)

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

negativeKeywordListsCount

string ( int64 format)

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

adGroupCriteriaCount

string ( int64 format)

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

Типы таргетинга:

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

string ( int64 format)

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

Типы таргетинга:

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

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

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

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

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