Генерирует и возвращает идентификатор отчета. Отчет не сохраняется в памяти. Повторные вызовы с тем же запросом приведут к повторной генерации отчета.
HTTP-запрос
POST https://dv360exchangereporting.googleapis.com/v1alpha1/{exchange=exchanges/*}:generateReport
В URL-адресе используется синтаксис транскодирования gRPC .
Параметры пути
| Параметры | |
|---|---|
exchange | Обязательно. Название биржи, к которой относится отчет. Пример: "exchanges/123" Обязательно. |
Текст запроса
Тело запроса содержит данные следующей структуры:
| JSON-представление |
|---|
{ "startDate": string, "endDate": string, "reportType": enum ( |
| Поля | |
|---|---|
startDate | Обязательно. Дата начала формирования отчетов в формате ISO_8601 ГГГГ-ММ-ДД включительно. Необходимо ввести эти данные. |
endDate | Обязательно. Дата окончания отчетов в формате ISO_8601 ГГГГ-ММ-ДД включительно. Необходимо ввести эти данные. |
reportType | Обязательно. Если тип отчета не указан, будут возвращены ошибки. |
dimensionIds[] | Необязательный параметр. Список параметров, на основе которых будет создан отчет. Если значение равно null, то будет указан только идентификатор издателя. Если параметры не поддерживаются в определенном типе отчета, они будут проигнорированы. |
Ответный текст
В случае успеха тело ответа содержит экземпляр объекта Report .
Области полномочий
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/doubleclickbidmanager
Для получения более подробной информации см.OAuth 2.0 Overview .
Тип отчета
Тип отчета.
| Перечисления | |
|---|---|
REPORT_TYPE_UNSPECIFIED | Тип отчета не указан, недопустимое входное значение. |
HOURLY | Тип отчета — почасовой. |
DAILY | Тип отчета: ежедневный. |
WEEKLY | Тип отчета: еженедельный. |
MONTHLY | Ежемесячный отчет. |
AWBID_DAILY | Тип отчета AwBid Daily. |
AWBID_WEEKLY | Тип еженедельного отчета AwBid. |
AWBID_MONTHLY | Тип ежемесячного отчета AwBid. |
AWBID_OUT_OF_MONTH_IVT | Тип отчета AwBid, выходящий за рамки текущего месяца. |
DimensionId
Отчет DimensionId enum.
| Перечисления | |
|---|---|
DIMENSION_ID_UNSPECIFIED | Размерность отчета не указана, недопустимое входное значение. |
PARTNER_ID | Идентификатор партнера (поддерживается только в ежедневном отчете). |
DEVICE_TYPE | Тип устройства, поддерживается только в ежедневном отчете. |
CREATIVE_ID | Идентификатор креатива (Creative ID) поддерживается только в ежедневных отчетах. Обратите внимание, что этот параметр может существенно увеличить размер файла отчетов. Кроме того, выполнение отчетов, содержащих этот параметр, может занять несколько часов. В будущем мы ограничим оценку для этих ресурсоемких полей. |
CREATIVE_TYPE | Тип креатива поддерживается только в ежедневных отчетах. Обратите внимание, что этот параметр может значительно увеличить размер файла отчетов. Кроме того, выполнение отчетов, содержащих этот параметр, может занять несколько часов. В будущем мы ограничим оценку для этих полей, сильно нагружающих данные. |
REGION_CODE | Код страны/региона поддерживается только в ежедневном отчете. |
DEAL_ID | Идентификатор сделки, сопоставление с источником запасов, поддерживается только в ежедневном отчете. |
PUBLISHER_ID | Идентификатор издателя; если список идентификаторов входных измерений пуст, используется измерение по умолчанию. |