Method: customers.googleAds.searchStream

Zwraca wszystkie wiersze pasujące do zapytania strumienia wyszukiwania.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v14/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 pozostałych wyników zapytania.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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
}
Pola
results[]

object (GoogleAdsRow)

Lista wierszy pasujących do zapytania.
fieldMask

string (FieldMask format)

Maska FieldMask określająca pola wymagane przez użytkownika.

Jest to lista rozdzielonych przecinkami 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ć sumy, średniej, współczynnika itp.
requestId

string

Unikalny identyfikator żądania używany do debugowania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.