Предыдущий Search Ads 360 Reporting API выведен из эксплуатации. Теперь вы можете создавать свои отчеты с помощью нового Search Ads 360 Reporting API .
Обратите внимание, что методы get и getByCustomerId в Search Ads 360 Conversion API устарели в третьем квартале 2025 года. Чтобы продолжить доступ к данным о конверсиях, необходимо создать отчет с использованием ресурса конверсии с помощью нового Search Ads 360 Reporting API. Подробнее см. здесь.
Остальные функции API конверсий Search Ads 360 будут по-прежнему поддерживаться.
Запросить отчеты
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании
нового API отчетов Search Ads 360 .
После настройки клиентского приложения, как описано в разделе «Мое первое приложение» , вы можете использовать API Search Ads 360 для запроса и скачивания отчетов. Вы можете сделать любой из следующих типов запросов:
- синхронный
Требуется всего один запрос и возвращает отчет в виде ответа в формате JSON. Синхронные запросы:
Если вы запрашиваете крупные отчеты по рекламодателям или системным аккаунтам, мы рекомендуем асинхронный подход.
- Асинхронный
Требуется отправить первоначальный запрос, в котором указаны данные, которые вы хотите включить в отчет. Затем вы отправляете дополнительные запросы на опрос Search Ads 360. Когда Search Ads 360 завершает создание отчета, вы отправляете запросы на загрузку отчета в виде одного или нескольких файлов. Асинхронные запросы:
- Может возвращать любой тип отчета
- Разбивает очень большие отчеты на несколько файлов.
- Форматирует отчеты как CSV или TSV.
Модель данных: строки и столбцы
Search Ads 360 упорядочивает данные в отчете по строкам и столбцам. Тип запрашиваемого отчета определяет возвращаемые строки . Например, если вы запросите отчет по ключевым словам, каждая строка будет содержать данные об одном ключевом слове. Список всех типов отчетов см. в справочнике по типам отчетов. Вы указываете, какие столбцы вы хотите видеть в отчете, называя каждый столбец в запросе отчета. Список столбцов, которые могут быть возвращены для каждого типа отчета, см. в справочнике по типам отчетов .
Поведение столбца
Поведение столбца зависит от типа данных, содержащихся в столбце (ссылка «Типы отчетов» отображает поведение каждого столбца):
Столбцы атрибутов . Столбец атрибутов содержит данные, которые настраивают или идентифицируют объект в кампании, например название кампании или ставку ключевого слова. API Search Ads 360 всегда возвращает текущее значение столбца атрибута независимо от даты или диапазона дат, указанных в запросе. Например, если вчера вы изменили ставку ключевого слова с 2,00 на 1,50, а затем запросили отчет по данным за прошлый месяц, отчет вернет значение 1,50 для ставки ключевого слова.
Метрические столбцы . Столбец показателей содержит данные об эффективности вашей кампании, например количество кликов по объявлению, количество посещений, зафиксированное тегом Floodlight, или доход. Если вы не укажете диапазон времени в один день, API вернет совокупное значение для столбцов показателей. Например, если вы запросите отчет по данным за прошлый месяц, API вернет общее количество кликов за последний месяц.
Сегментировать столбцы . Столбец сегмента разбивает данные на отдельные строки. Например, date — это столбец сегмента, который можно указать для многих типов отчетов. Если вы укажете столбец date в отчете по ключевым словам с диапазоном дат с 1 января 2013 г. по 07 января 2013 г., API вернет семь строк для каждого ключевого слова, каждая из которых соответствует одному дню и отображает показатели для этого дня. См. Сегментированные отчеты .
Валюты
В запросе отчета необходимо указать валюту денежных данных (как атрибутов, таких как dailyBudget , так и таких показателей, как cost ). Вы можете указать одно из следующих:
- Валюта агентства, если область действия отчета ограничена агентством, рекламодателем или учетной записью системы.
- Валюта рекламодателя, если область действия отчета ограничена учетной записью рекламодателя или системы.
- Валюта системного аккаунта, если область действия отчета ограничена системным аккаунтом.
- доллар США
Используйте свойство запроса Reports.request.statisticsCurrency , чтобы указать валюту.
В самом отчете валюта будет указана в свойстве Reports.statisticsCurrencyCode .
Часовой пояс
Показатели Search Ads 360 хранятся в датах без часовых поясов. Эти даты соответствуют часовому поясу системного аккаунта для показателей системы (таких как клики, показы и посещения) и часовому поясу сети Менеджера кампаний для показателей конверсий (таких как действия, транзакции и доход). Если все показатели в отчете относятся к одному и тому же часовому поясу, этот часовой пояс будет возвращен в запросе. В противном случае часовой пояс не будет возвращен. В ваших запросах можно установить Reports.request.verifySingleTimeZone : true , чтобы отклонить отчеты, в которых представлены показатели из более чем одного часового пояса.
Если все метрики, присутствующие в отчете, относятся к одному часовому поясу, этот часовой пояс возвращается в Reports.statisticsTimeZoneReports .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers enhanced flexibility for building custom reports and integrating data into your workflows.\u003c/p\u003e\n"],["\u003cp\u003eYou can make synchronous requests for quick advertiser and engine account reports, or asynchronous requests for larger reports and various report types.\u003c/p\u003e\n"],["\u003cp\u003eReports are organized into rows based on the report type and columns that you specify in your request, with attribute, metric, and segment columns behaving differently.\u003c/p\u003e\n"],["\u003cp\u003eWhen requesting reports, you need to specify the currency for monetary data, and Search Ads 360 handles time zones based on engine and conversion metric sources.\u003c/p\u003e\n"]]],["The Search Ads 360 Reporting API allows custom report building and data integration. Reports can be requested synchronously (limited to advertiser/engine account reports, JSON format, blocking) or asynchronously (all report types, CSV/TSV format, multiple files). Data is organized in rows and columns; column behavior varies by type (attribute, metric, segment). Currency for monetary data must be specified and can be the agency's, advertiser's, or engine account's or USD. Time zones are relevant to metric dates.\n"],null,["# Request Reports\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app), you can use the Search Ads 360 API\nto request and download reports. You can make either of the following types of\nrequests:\n\n**[Synchronous](/search-ads/v2/how-tos/reporting/synchronous-requests)**\n\n: Requires just a single request and returns the report in a JSON-formatted response. Synchronous requests:\n\n - Can return only [advertiser](/search-ads/v2/report-types/advertiser) and [engine account](/search-ads/v2/report-types/account) reports\n - Block your client until Search Ads 360 generates the report\n\n\n If you're requesting large advertiser or engine-account reports, we recommend the\n asynchronous approach.\n\n**[Asynchronous](/search-ads/v2/how-tos/reporting/asynchronous-requests)**\n\n: Requires you to send an initial request that specifies the data you want in the\n report. Then you send additional requests to poll Search Ads 360. When Search Ads 360 finishes generating the report,\n you send requests to download the report as one or more files. Asynchronous requests:\n\n - Can return any [report type](/search-ads/v2/report-types)\n - Shards very large reports into multiple files\n - Formats reports as CSV or TSV\n\n### Data model: rows and columns\n\nSearch Ads 360 organizes data in a report into rows and columns.\nThe type of report you request determines the **rows** that are returned.\nFor example, if your request a keyword report, each row will contain data about a single\nkeyword. See the [Report Types](/search-ads/v2/report-types)\nreference for a list of all report types.\nYou specify which **columns** you want in the report by naming each column\nin your report request. See the [Report\nTypes](/search-ads/v2/report-types) reference for the list of columns that can be returned for each report type.\n\n### Column behaviors\n\n\nThe behavior of a column depends on the type of data that the column\ncontains (the [Report Types](/search-ads/v2/report-types) reference\ndisplays each column's behavior):\n\n-\n **Attribute columns**. An attribute column contains data that configures\n or identifies an entity in a campaign, such as the campaign name or a keyword bid. The Search Ads 360 API\n always returns the current value for an attribute column, regardless of any date or\n date range specified in a request. For example, if you changed a keyword's bid from\n 2.00 to 1.50 yesterday and then request a report for last month's data, the report\n will return a value of 1.50 for the keyword bid.\n\n-\n **Metric columns** . A metric column contains data about your campaign's\n performance, such as the number of clicks on an ad, the number of visits as recorded\n by a Floodlight tag, or revenue. Unless you [specify a\n time range](/search-ads/v2/reference/reports#request.timeRange) of a single day, the API returns an aggregate value for metric columns. For\n example, if you request a report for last month's data, the API will return the total\n number of clicks for last month.\n\n-\n **Segment columns** . A segment column splits data into separate rows.\n For example, `date` is a segment column that you can specify for many\n types of reports. If you specify the `date` column in a keyword report\n with a date range 2013-01-01 to 2013-01-07, the API would return seven rows for each\n keyword, each corresponding to one day and displaying metrics for that day. See [Segmented\n Reports](/search-ads/v2/how-tos/reporting/segmented-reports).\n\n### Currencies\n\n\nYour report request is required to specify the currency of monetary data (both attributes like `dailyBudget` and metrics like\n`cost`). You can specify one of the following:\n\n- The agency's currency, if the report is [scoped](/search-ads/v2/reference/reports#request.reportScope) to an agency, advertiser, or engine account.\n- The advertiser's currency, if the report is scoped to an advertiser or engine account.\n- The engine account's currency, if the report is scoped to an engine account.\n- USD\n\n\nUse the [Reports.request.statisticsCurrency](/search-ads/v2/reference/reports#request.statisticsCurrency)\nrequest property to specify a currency.\n\n\nThe report itself will indicate the currency in the ` `[Reports.statisticsCurrencyCode](/search-ads/v2/reference/reports#statisticsCurrencyCode) property.\n\n### Time zone\n\n\nSearch Ads 360 metrics are stored in dates without time zones. These dates correspond to the engine\naccount time zone for engine metrics (such as clicks, impressions, and visits), and\nCampaign Manager network time zone for conversion metrics (such as actions,\ntransactions and revenue). When every metric in a report comes from the same time zone,\nthat time zone will be returned in the request. Otherwise, no time zone will be returned.\nYour requests can set [Reports.request.verifySingleTimeZone](/search-ads/v2/reference/reports#request.verifySingleTimeZone)`: true`\nto fail reports that present metric from more than one time zone.\n\n\nIf all metrics present in a report are from one time zone, that time zone is\nreturned in [Reports.statisticsTimeZoneReports](/search-ads/v2/reference/reports#statisticsTimeZone)."]]
