Interfejs Google Ads API udostępnia ujednolicony mechanizm pobierania atrybutów i raportowania danych, który umożliwia tworzenie zapytań za pomocą języka zapytań Google Ads. Umożliwia to tworzenie złożonych zapytań, które mogą zwracać duże ilości danych o poszczególnych kontach Google Ads.
Zapytania możesz tworzyć za pomocą metod Search lub SearchStream.
Obie metody obsługują te same zapytania i zwracają te same wyniki. Metoda Search zwraca dane na stronach o stałym rozmiarze 10 tys. wierszy, co umożliwia iterację w zbiorze wyników za pomocą podziału na strony. Może to być korzystne w przypadku niskiej przepustowości lub niestabilnych warunków sieciowych, np. do podziału dużego zbioru wyników na mniejsze odpowiedzi, które można ponownie pobrać, jeśli połączenie zostanie utracone. Z kolei metoda SearchStream przesyła strumieniowo cały ustawiony wynik w pojedynczej odpowiedzi, co może być bardziej wydajne w przypadku zbiorczego pobierania danych.
Zarówno Search, jak i SearchStream używają tego samego podstawowego adresu URL:
https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds
POST /v18/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'" }
Jeśli wyniki zawierają więcej niż 10 tys. wierszy,w odpowiedzi zwracana jest wartość nextPageToken:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Powtórzenie tego samego zapytania z dodaną wartością pageToken z poprzedniego żądania spowoduje pobranie następnej strony wyników:
POST /v18/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" }
Aby użyć metody SearchStream, która zwraca wszystkie wyniki w jednej przesyłanej strumieniowo odpowiedzi, zmień metodę usługi w adresie URL na searchStream (parametry pageToken nie są wymagane w przypadku metody SearchStream):
POST /v18/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'" }