Предыдущая версия Search Ads 360 Reporting API будет прекращена и будет прекращена 30 июня 2024 года. Обратите внимание, что это не повлияет на Search Ads 360 Conversion API и продолжит поддерживаться. При разработке всех новых отчетов следует использовать новый Search Ads 360 Reporting API .

Начиная с апреля 2024 г. при запросе отчета будет возвращаться ошибка unsupportedApiVersion. Подробности смотрите здесь .

Мы также настоятельно рекомендуем вам перенести все существующие реализации Search Ads 360 на новый API. Дополнительную информацию можно найти в новом руководстве по началу работы и переходу к Search Ads 360 Reporting API.

Эта страница переведена с помощью Cloud Translation API.

Reports

Список методов для этого ресурса см. в конце этой страницы.

Представления ресурсов

Отчет о поиске 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`	Возвращает метрики только для определенного типа активности продукта. Допустимые значения: " `sold` ": возвращает показатели только для проданных товаров. " `advertised` ": возвращает показатели только для продуктов, которые рекламировались в торговой кампании и которые могли или не могли быть проданы.
`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`	Возвращает метрики только для определенного типа активности продукта. Допустимые значения: " `sold` ": возвращает показатели только для проданных товаров. " `advertised` ": возвращает показатели только для продуктов, которые рекламировались в торговой кампании и которые могли или не могли быть проданы.
`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`	Возвращает метрики только для определенного типа активности продукта. Допустимые значения: " `sold` ": возвращает показатели только для проданных товаров. " `advertised` ": возвращает показатели только для продуктов, которые рекламировались в торговой кампании и которые могли или не могли быть проданы.
`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.
запрос: Вставляет запрос отчета в систему отчетности.