Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
Отчет о поиске DoubleClick. Этот объект содержит запрос отчета, некоторые метаданные отчета, такие как код валюты, и сгенерированные строки отчета или файлы отчетов.
{ "kind": "doubleclicksearch#report", "id": string, "isReportReady": boolean, "request": { "reportScope": { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "adGroupId": long, "keywordId": long, "adId": long }, "reportType": string, "columns": [ { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string } ], "timeRange": { "startDate": string, "endDate": string, "changedMetricsSinceTimestamp": datetime, "changedAttributesSinceTimestamp": datetime }, "filters": [ { "column": { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string }, "operator": string, "values": [ (value) ] } ], "orderBy": [ { "column": { "columnName": string, "savedColumnName": string, "customDimensionName": string, "customMetricName": string, "headerText": string, "startDate": string, "endDate": string, "groupByColumn": boolean, "platformSource": string, "productReportPerspective": string }, "sortOrder": string } ], "includeDeletedEntities": boolean, "includeRemovedEntities": boolean, "verifySingleTimeZone": boolean, "downloadFormat": string, "statisticsCurrency": string, "startRow": integer, "rowCount": integer, "maxRowsPerFile": integer }, "statisticsCurrencyCode": string, "statisticsTimeZone": string, "rowCount": integer, "files": [ { "url": string, "byteCount": long } ], "rows": [ { (key): (value) } ] }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
files[] | list | Только асинхронный отчет. Содержит список сгенерированных файлов отчета после успешного завершения отчета. | |
files[]. byteCount | long | Размер этого файла отчета в байтах. | |
files[]. url | string | Используйте этот URL-адрес для загрузки файла отчета. | |
id | string | Только асинхронный отчет. Идентификатор отчета. | |
isReportReady | boolean | Только асинхронный отчет. Истинно тогда и только тогда, когда отчет успешно завершен и файлы отчета готовы к загрузке. | |
kind | string | Идентифицирует это как ресурс отчета. Значение: фиксированная строка doubleclicksearch#report . | |
request | nested object | Запрос, по которому был создан отчет. Необязательные поля, не указанные в исходном запросе, заполняются значениями по умолчанию. | |
request. columns[] | list | Столбцы для включения в отчет. Сюда входят как столбцы DoubleClick Search, так и сохраненные столбцы. Для столбцов DoubleClick Search требуется только параметр columnName . Для сохраненных столбцов требуется только параметр savedColumnName . И columnName , и savedColumnName не могут быть установлены в одном и том же разделе.Максимальное количество столбцов в запросе — 300. | |
request.columns[]. columnName | string | Название столбца DoubleClick Search, который нужно включить в отчет. | |
request.columns[]. customDimensionName | string | Сегментирует отчет по пользовательскому параметру. Отчет должен быть ограничен рекламодателем или ниже, а специальный параметр должен быть уже настроен в DoubleClick Search. Название специального параметра, отображаемое в DoubleClick Search, чувствительно к регистру. При использовании в отчете о конверсиях возвращает значение указанного специального параметра для данной конверсии, если он задан. Этот столбец не сегментирует отчет о переходах. | |
request.columns[]. customMetricName | string | Имя специальной метрики для включения в отчет. Отчет должен быть ограничен рекламодателем или ниже, а специальный показатель должен быть уже настроен в DoubleClick Search. Название специальной метрики, отображаемое в DoubleClick Search, чувствительно к регистру. | |
request.columns[]. endDate | string | Включительный день в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с startDate . | |
request.columns[]. groupByColumn | boolean | Только синхронный отчет. Установите значение true для группировки по этому столбцу. По умолчанию false . | |
request.columns[]. headerText | string | Текст, используемый для идентификации этого столбца в выходных данных отчета; по умолчанию используется columnName или savedColumnName , если не указано иное. Это можно использовать для предотвращения конфликтов между столбцами DoubleClick Search и сохраненными столбцами с одинаковыми именами. | |
request.columns[]. platformSource | string | Платформа, используемая для предоставления данных для специального параметра. Допустимые значения — «прожектор». | |
request.columns[]. productReportPerspective | string | Возвращает метрики только для определенного типа активности продукта. Допустимые значения:
| |
request.columns[]. savedColumnName | string | Имя сохраненного столбца для включения в отчет. Область действия отчета должна быть на уровне рекламодателя или ниже, а этот сохраненный столбец уже должен быть создан в пользовательском интерфейсе DoubleClick Search. | |
request.columns[]. startDate | string | Включающая дата в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с endDate . | |
request. downloadFormat | string | Формат, в котором должен быть возвращен отчет. В настоящее время поддерживается csv или tsv . | |
request. filters[] | list | Список фильтров, которые необходимо применить к отчету. Максимальное количество фильтров на запрос — 300. | |
request.filters[]. column | nested object | Столбец для выполнения фильтра. Это может быть столбец поиска DoubleClick или сохраненный столбец. | |
request.filters[].column. columnName | string | Название столбца DoubleClick Search, который нужно включить в отчет. | |
request.filters[].column. customDimensionName | string | Сегментирует отчет по пользовательскому параметру. Отчет должен быть ограничен рекламодателем или ниже, а специальный параметр должен быть уже настроен в DoubleClick Search. Название специального параметра, отображаемое в DoubleClick Search, чувствительно к регистру. При использовании в отчете о конверсиях возвращает значение указанного специального параметра для данной конверсии, если он установлен. Этот столбец не сегментирует отчет о переходах. | |
request.filters[].column. customMetricName | string | Имя специальной метрики для включения в отчет. Отчет должен быть ограничен рекламодателем или ниже, а специальный показатель должен быть уже настроен в DoubleClick Search. Название специальной метрики, отображаемое в DoubleClick Search, чувствительно к регистру. | |
request.filters[].column. endDate | string | Включительный день в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с startDate . | |
request.filters[].column. groupByColumn | boolean | Только синхронный отчет. Установите значение true для группировки по этому столбцу. По умолчанию false . | |
request.filters[].column. headerText | string | Текст, используемый для идентификации этого столбца в выходных данных отчета; по умолчанию используется columnName или savedColumnName , если не указано иное. Это можно использовать для предотвращения конфликтов между столбцами DoubleClick Search и сохраненными столбцами с одинаковыми именами. | |
request.filters[].column. platformSource | string | Платформа, используемая для предоставления данных для специального параметра. Допустимые значения — «прожектор». | |
request.filters[].column. productReportPerspective | string | Возвращает метрики только для определенного типа активности продукта. Допустимые значения:
| |
request.filters[].column. savedColumnName | string | Имя сохраненного столбца для включения в отчет. Область действия отчета должна быть на уровне рекламодателя или ниже, а этот сохраненный столбец уже должен быть создан в пользовательском интерфейсе DoubleClick Search. | |
request.filters[].column. startDate | string | Включающая дата в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с endDate . | |
request.filters[]. operator | string | Оператор для использования в фильтре. Список доступных операторов см. в справочнике по фильтрам. | |
request.filters[]. values[] | list | Список значений для фильтрации значения столбца. Максимальное количество значений фильтра на запрос — 300. | |
request. includeDeletedEntities | boolean | Определяет, следует ли включать удаленные объекты в отчет. По умолчанию false . Устарело, вместо этого используйте includeRemovedEntities . | |
request. includeRemovedEntities | boolean | Определяет, следует ли включать удаленные объекты в отчет. По умолчанию false . | |
request. maxRowsPerFile | integer | Только асинхронный отчет. Максимальное количество строк в файле отчета. Большой отчет разбивается на множество файлов на основе этого поля. Допустимые значения: 1000000 до 100000000 включительно. | |
request. orderBy[] | list | Только синхронный отчет. Список столбцов и направлений, определяющих сортировку строк отчета. Максимальное количество заказов на один запрос — 300. | |
request.orderBy[]. column | nested object | Столбец, по которому выполняется сортировка. Это может быть столбец, определенный DoubleClick Search, или сохраненный столбец. | |
request.orderBy[].column. columnName | string | Название столбца DoubleClick Search, который нужно включить в отчет. | |
request.orderBy[].column. customDimensionName | string | Сегментирует отчет по пользовательскому параметру. Отчет должен быть ограничен рекламодателем или ниже, а специальный параметр должен быть уже настроен в DoubleClick Search. Название специального параметра, отображаемое в DoubleClick Search, чувствительно к регистру. При использовании в отчете о конверсиях возвращает значение указанного специального параметра для данной конверсии, если он задан. Этот столбец не сегментирует отчет о переходах. | |
request.orderBy[].column. customMetricName | string | Имя специальной метрики для включения в отчет. Отчет должен быть ограничен рекламодателем или ниже, а специальный показатель должен быть уже настроен в DoubleClick Search. Название специальной метрики, отображаемое в DoubleClick Search, чувствительно к регистру. | |
request.orderBy[].column. endDate | string | Включительный день в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с startDate . | |
request.orderBy[].column. groupByColumn | boolean | Только синхронный отчет. Установите значение true для группировки по этому столбцу. По умолчанию false . | |
request.orderBy[].column. headerText | string | Текст, используемый для идентификации этого столбца в выходных данных отчета; по умолчанию используется columnName или savedColumnName , если не указано иное. Это можно использовать для предотвращения конфликтов между столбцами DoubleClick Search и сохраненными столбцами с одинаковыми именами. | |
request.orderBy[].column. platformSource | string | Платформа, используемая для предоставления данных для специального параметра. Допустимые значения — «прожектор». | |
request.orderBy[].column. productReportPerspective | string | Возвращает метрики только для определенного типа активности продукта. Допустимые значения:
| |
request.orderBy[].column. savedColumnName | string | Имя сохраненного столбца для включения в отчет. Область действия отчета должна быть на уровне рекламодателя или ниже, а этот сохраненный столбец уже должен быть создан в пользовательском интерфейсе DoubleClick Search. | |
request.orderBy[].column. startDate | string | Включающая дата в формате ГГГГ-ММ-ДД. При наличии переопределяет общий временной диапазон отчета только для этого столбца. Должен быть предоставлен вместе с endDate . | |
request.orderBy[]. sortOrder | string | Направление сортировки: ascending или descending . | |
request. reportScope | object | reportScope — это набор идентификаторов, которые используются для определения того, какое подмножество сущностей будет возвращено в отчете. Требуется полная родословная идентификаторов от самого низкого желаемого уровня охвата до агентства. | |
request.reportScope. adGroupId | long | Идентификатор группы объявлений DS. | |
request.reportScope. adId | long | Идентификатор объявления ДС. | |
request.reportScope. advertiserId | long | Идентификатор рекламодателя DS. | |
request.reportScope. agencyId | long | Идентификатор агентства DS. | |
request.reportScope. campaignId | long | Идентификатор кампании DS. | |
request.reportScope. engineAccountId | long | Идентификатор учетной записи механизма DS. | |
request.reportScope. keywordId | long | Идентификатор ключевого слова DS. | |
request. reportType | string | Определяет тип строк, возвращаемых в отчете. Например, если указать reportType: keyword , каждая строка в отчете будет содержать данные о ключевом слове. См. справочник по типам отчетов , чтобы узнать о столбцах, доступных для каждого типа. | |
request. rowCount | integer | Только синхронный отчет. Максимальное количество возвращаемых строк; дополнительные строки удаляются. Допустимые значения: от 0 до 10000 включительно. По умолчанию 10000 . | |
request. startRow | integer | Только синхронный отчет. Отсчитываемый от нуля индекс первой возвращаемой строки. Допустимые значения: от 0 до 50000 включительно. По умолчанию 0 . | |
request. statisticsCurrency | string | Указывает валюту, в которой будут возвращены денежные средства. Возможные значения: usd , agency (действительно, если отчет ограничен агентством или ниже), advertiser (действительно, если отчет ограничен * рекламодателем или ниже) или account (действительно, если отчет ограничен учетной записью движка или ниже). . | |
request. timeRange | object | Если в отчете запрашиваются метрики, этот аргумент будет использоваться для ограничения метрик определенным диапазоном времени. | |
request.timeRange. changedAttributesSinceTimestamp | datetime | Включающая временная метка UTC в формате RFC, например, 2013-07-16T10:16:23.555Z . См. дополнительные справочные материалы о том, как работают отчеты об измененных атрибутах. | |
request.timeRange. changedMetricsSinceTimestamp | datetime | Включающая временная метка UTC в формате RFC, например, 2013-07-16T10:16:23.555Z . См. дополнительные справочные материалы о том, как работают отчеты об измененных показателях. | |
request.timeRange. endDate | string | Включающая дата в формате ГГГГ-ММ-ДД. | |
request.timeRange. startDate | string | Включающая дата в формате ГГГГ-ММ-ДД. | |
request. verifySingleTimeZone | boolean | Если true , отчет будет создан только в том случае, если все запрошенные статистические данные получены из одного часового пояса. По умолчанию false . | |
rowCount | integer | Количество строк отчета, сгенерированных отчетом, не включая заголовки. | |
rows[] | list | Только синхронный отчет. Сгенерированные строки отчета. | |
rows[]. (key) | any value | Указывает столбцы, представленные в этой строке. То есть каждому ключу соответствует столбец с непустой ячейкой в этой строке. | |
statisticsCurrencyCode | string | Код валюты всех денежных значений, представленных в отчете, включая значения, установленные пользователями (например, настройки ставок для ключевых слов) и показатели (например, затраты и доход). Код валюты отчета определяется полем statisticsCurrency запроса отчета. | |
statisticsTimeZone | string | Если вся статистика отчета получена из одного и того же часового пояса, это будет так. В противном случае поле не установлено. |
Методы
- генерировать
- Создает и немедленно возвращает отчет.
- получать
- Опросы статуса запроса отчета.
- получить файл
- Загружает файл отчета в кодировке UTF-8.
- getIdMappingFile
- Загружает файл CSV (в кодировке UTF-8), который содержит сопоставления идентификаторов между предыдущей версией Search Ads 360 и новой Search Ads 360. Для запрошенного рекламодателя файл включает все дочерние объекты (например, учетные записи системы, кампании, группы объявлений и т. д.). .), которые существуют как в предыдущей версии Search Ads 360, так и в новой Search Ads 360.
- запрос
- Вставляет запрос отчета в систему отчетности.