Видео : Репортаж
API Google Ads имеет унифицированный механизм получения атрибутов и формирования отчетов по метрикам , позволяющий создавать запросы с использованием языка запросов Google Ads . Это позволяет выполнять сложные запросы, которые могут возвращать большие объемы данных об отдельных аккаунтах Google Ads.
Вы можете создавать запросы, используя методы Search или SearchStream . Оба метода поддерживают одни и те же запросы и возвращают эквивалентные результаты. Метод Search возвращает данные в виде страниц фиксированного размера по 10 000 строк, что позволяет итерировать по набору результатов с использованием пагинации. Это может быть полезно, например, при низкой пропускной способности или нестабильной сети, для сегментации большого набора результатов на более мелкие ответы, которые можно повторно получить в случае потери соединения. Метод SearchStream , с другой стороны, передает весь набор результатов обратно в одном ответе, что может быть более эффективно для получения больших объемов данных.
И Search , и SearchStream используют один и тот же базовый URL:
https://googleads.googleapis.com/v23/customers/CUSTOMER_ID/googleAds
POST /v23/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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 /v23/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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 /v23/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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'" }