Interfejs Google Ads API udostępnia ujednolicone pobieranie atrybutów i raportowanie danych która pozwala tworzyć zapytania za pomocą zapytania Google Ads Język. Umożliwia to obsługę złożonych zapytań, które mogą zwracać duże ilości danych indywidualnych kont Google Ads.
Zapytania możesz tworzyć za pomocą jednej z metod Search lub SearchStream.
Obie metody obsługują te same zapytania i zwracają równoważne wyniki.
Metoda Search zwraca dane na stronach o stałym rozmiarze liczącym 10 000 wierszy,
w celu iteracji w zbiorze wyników za pomocą podziału na strony. Może to być korzystne przy niskim
czy niestabilne warunki sieciowe, np. do segmentowania dużych
wynikowy wynik w postaci mniejszych odpowiedzi, które można pobrać ponownie, jeśli połączenie jest
zgubiony. Metoda SearchStream natomiast przesyła strumieniowo cały wynik
co może być lepsze w przypadku danych zbiorczych.
pobieranie danych.
Zarówno Search, jak i SearchStream używają tego samego podstawowego adresu URL:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/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 w wynikach jest więcej niż 10 000 wierszy,nextPageToken
zwrócony w odpowiedzi:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Powtórz to samo zapytanie z parametrem pageToken dodanym z wartościami z pola
poprzednie żądanie pobiera następną stronę wyników:
POST /v17/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 ramach 1 transmisji
zmień metodę usługi w adresie URL na searchStream
(pageSize i pageToken nie są wymagane do SearchStream):
POST /v17/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'"
}