Wyszukiwarka i SearchStream

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Interfejs Search Ads 360 Reporting API udostępnia ujednolicone pobieranie atrybutów i raportowanie danych która pozwala tworzyć zapytania za pomocą zapytania Search Ads 360 Język. Umożliwia to obsługę złożonych zapytań, które mogą zwracać duże ilości danych indywidualnych kont Search Ads 360.

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 w rozmiarach stron, które można dostosować, co umożliwia iterację. nad wynikami ustawionymi za pomocą podziału na strony. Może to być przydatne w przypadku niskiej przepustowości łącza. lub niestabilne warunki sieciowe, na przykład w celu segmentowania dużego zestawu wyników na mniejsze odpowiedzi, które można pobrać ponownie w przypadku utraty połączenia. metoda SearchStream przesyła strumieniowo cały ustawiony wynik z powrotem jedna odpowiedź, co może być efektywniejsze w przypadku zbiorczego pobierania danych.

Zarówno Search, jak i SearchStream używają tego samego podstawowego adresu URL:

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

Metoda wyszukiwania na podstawie strony przyjmuje opcjonalny parametr pageSize, który ogranicza ile wyników jest zwracanych w jednej odpowiedzi interfejsu API.

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"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 wierszy niż pageSize, wartość nextPageToken wynosi zwrócony w odpowiedzi:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

Powtarzanie tego samego zapytania z dodanym parametrem pageToken z wartością podaną powyżej pobierania następna strona wyników:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"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 , wystarczy zmienić metodę usługi w adresie URL na searchStream (pageSize i pageToken nie są wymagane do SearchStream):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.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'"
}