Method: customers.googleAds.searchStream

Gibt alle Zeilen zurück, die mit der Suchstreamabfrage übereinstimmen.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError ChangeEventError ChangeStatusError ClickViewError HeaderError InternalError QueryError QuotaError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:searchStream

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des abgefragten Kunden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "query": string,
  "summaryRowSetting": enum (SummaryRowSetting)
}
Felder
query

string

Erforderlich. Der Abfragestring.
summaryRowSetting

enum (SummaryRowSetting)

Legt fest, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Bei Anforderung wird die Zusammenfassungszeile in einer Antwort gesendet, nachdem alle anderen Abfrageergebnisse zurückgegeben wurden.

Antworttext

Antwortnachricht für GoogleAdsService.SearchStream.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "results": [
    {
      object (GoogleAdsRow)
    }
  ],
  "fieldMask": string,
  "summaryRow": {
    object (GoogleAdsRow)
  },
  "requestId": string
}
Felder
results[]

object (GoogleAdsRow)

Die Liste der Zeilen, die der Abfrage entsprechen.
fieldMask

string (FieldMask format)

FieldMask, die angibt, welche Felder vom Nutzer angefordert wurden.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
summaryRow

object (GoogleAdsRow)

Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen Bei der Zusammenfassung von Metriken werden die Metriken für alle Ergebnisse zusammengefasst. Die Aggregation kann in diesem Fall Summe, Durchschnitt, Rate usw. sein.
requestId

string

Die eindeutige ID der Anfrage, die zum Debugging verwendet wird.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.