Zwraca wszystkie wiersze pasujące do zapytania w strumieniu wyszukiwania.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError
Żądanie HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/googleAds:searchStream
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta, którego dotyczy zapytanie. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"query": string,
"summaryRowSetting": enum ( |
Pola | |
---|---|
query |
To pole jest wymagane. Ciąg zapytania. |
summaryRowSetting |
Określa, czy wiersz podsumowania zostanie zwrócony. Domyślnie wiersz podsumowania nie jest zwracany. Na żądanie wiersz podsumowania zostanie wysłany w odpowiedzi po zwróceniu wszystkich innych wyników zapytania. |
Treść odpowiedzi
Odpowiedź na pytanie: GoogleAdsService.SearchStream
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "results": [ { object ( |
Pola | |
---|---|
results[] |
Lista wierszy pasujących do zapytania. |
fieldMask |
Maska FieldMask określająca pola, których zażądał użytkownik. Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. Przykład: |
summaryRow |
Wiersz podsumowania zawierający podsumowanie danych w wynikach. Podsumowanie danych oznacza agregację danych ze wszystkich wyników. W tym przypadku agregacja może mieć postać sumę, średnią, współczynnik itp. |
requestId |
Unikalny identyfikator żądania, który jest używany do debugowania. |
queryResourceConsumption |
Ilość zasobów zużywanych na potrzeby obsługi zapytania. Zapytanie queryResourceConsumption w wierszu Podsumowanie i odpowiedzi innych niż Podsumowanie są zwracane oddzielnie w odpowiednich wierszach. Zapytanie queryResourceConsumption w przypadku odpowiedzi innych niż podsumowanie jest zwracane w ostatecznej grupie wyników. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/adwords
Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.