В Google Ads API есть единый механизм получения атрибутов и создания отчетов о показателях, который позволяет создавать запросы с помощью языка запросов Google Рекламы. Это позволяет выполнять сложные запросы, которые могут возвращать большие объемы данных об отдельных аккаунтах Google Рекламы.
Вы можете создавать запросы с помощью методов Search или SearchStream.
Оба метода поддерживают одинаковые запросы и возвращают эквивалентные результаты. Метод Search возвращает данные на страницах фиксированного размера (10 000 строк), что позволяет перебирать набор результатов с помощью разбивки на страницы. Это может быть полезно при низкой пропускной способности или ненадежном сетевом подключении, например, чтобы разделить большой набор результатов на меньшие ответы, которые можно повторно получить в случае потери соединения. Метод SearchStream, напротив, передает весь набор результатов в одном ответе, что может быть более эффективно при извлечении больших объемов данных.
У Search и SearchStream один и тот же базовый URL:
https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
Если в результатах более 10 000 строк,в ответе возвращается nextPageToken:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Повторив тот же запрос с добавлением pageToken со значениями из предыдущего запроса, вы получите следующую страницу результатов:
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
Чтобы использовать метод SearchStream, который возвращает все результаты в одном потоковом ответе, измените метод сервиса в URL на searchStream (pageToken не требуется для SearchStream):
POST /v26/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }