Method: exchanges.generateReport

Генерирует и возвращает идентификатор отчета. Отчет не сохраняется. Вызовы с тем же запросом будут повторно генерировать отчет.

HTTP-запрос

POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport

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

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

Параметры
exchange

string

Необходимый. Название биржи, о которой сообщается, что она принадлежит. Пример: «exchanges/123». Обязательно.

Тело запроса

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

JSON-представление 
{
  "startDate": string,
  "endDate": string,
  "reportType": enum (ReportType),
  "dimensionIds": [
    enum (DimensionId)
  ]
}
Поля
startDate

string

Необходимый. Дата начала отчетов в формате ISO_8601 ГГГГ-ММ-ДД включительно. Требуется в качестве входных данных.

endDate

string

Необходимый. Дата окончания отчетов в формате ISO_8601 ГГГГ-ММ-ДД включительно. Требуется в качестве входных данных.

reportType

enum ( ReportType )

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

dimensionIds[]

enum ( DimensionId )

Необязательный. Список измерений, на основе которых будет создан отчет. Если значение равно нулю, укажите только идентификатор издателя. Если измерения не поддерживаются в отчете определенного типа, они будут игнорироваться.

Тело ответа

В случае успеха тело ответа содержит экземпляр Report .

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

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

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

Тип отчета

Тип отчета.

Перечисления
REPORT_TYPE_UNSPECIFIED Тип отчета не указан, неверное входное значение
HOURLY Тип отчета ежечасно.
DAILY Тип отчета: ежедневно.
WEEKLY Тип отчета еженедельный.
MONTHLY Тип отчета: ежемесячно.

Идентификатор измерения

Перечисление DimensionId отчета.

Перечисления
DIMENSION_ID_UNSPECIFIED Размер отчета не указан, недопустимое входное значение.
PARTNER_ID Идентификатор партнера, поддерживается только в ежедневном отчете.
DEVICE_TYPE Тип устройства, поддерживается только в ежедневном отчете.
CREATIVE_ID Идентификатор объявления, поддерживается только в ежедневном отчете. Обратите внимание, что этот размер может существенно повлиять на размер файла отчетов. И отчеты, включающие это измерение, могут занять несколько часов. В будущем мы ограничим рейтинг на этих полях с большой нагрузкой.
CREATIVE_TYPE Тип креатива, поддерживается только в ежедневном отчете. Обратите внимание, что этот размер может существенно повлиять на размер файла отчетов. И отчеты, включающие это измерение, могут занять несколько часов. В будущем мы ограничим рейтинг на этих полях с большой нагрузкой.
REGION_CODE Код страны/региона поддерживается только в ежедневном отчете.
DEAL_ID Идентификатор сделки, сопоставленный с источником инвентаря, поддерживается только в ежедневном отчете.
PUBLISHER_ID Идентификатор издателя. Если список идентификаторов входного измерения имеет значение null, это измерение по умолчанию.