Method: customers.googleAds.searchStream

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/v15/customers/{customerId}/googleAds:searchStream

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

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 (SummaryRowSetting)
}
Pola
query

string

To pole jest wymagane. Ciąg zapytania.
summaryRowSetting

enum (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 (GoogleAdsRow)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "requestId": string,
  "queryResourceConsumption": string
}
Pola
results[]

object (GoogleAdsRow)

Lista wierszy pasujących do zapytania.
fieldMask

string (FieldMask format)

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: "user.displayName,photo".
summaryRow

object (GoogleAdsRow)

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

string

Unikalny identyfikator żądania, który jest używany do debugowania.
queryResourceConsumption

string (int64 format)

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.