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/v15/customers/{customerId}/googleAds:searchStream
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
customerId |
Erforderlich. Die ID des abgefragten Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"query": string,
"summaryRowSetting": enum ( |
Felder | |
---|---|
query |
Erforderlich. Der Abfragestring. |
summaryRowSetting |
Bestimmt, ob eine Zusammenfassungszeile zurückgegeben wird. Standardmäßig wird keine Zusammenfassungszeile zurückgegeben. Bei Anfrage 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 ( |
Felder | |
---|---|
results[] |
Die Liste der Zeilen, die der Abfrage entsprechen. |
fieldMask |
FieldMask, die angibt, welche Felder vom Nutzer angefordert wurden. Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: |
summaryRow |
Zusammenfassungszeile mit einer Zusammenfassung der Messwerte in den Ergebnissen. Bei der Zusammenfassung der Messwerte werden die Messwerte für alle Ergebnisse zusammengefasst. Die Aggregation kann in diesem Fall Summe, Durchschnitt, Rate usw. sein. |
requestId |
Die eindeutige ID der Anfrage, die für die Fehlerbehebung verwendet wird. |
queryResourceConsumption |
Die für die Abfrage verbrauchte Ressourcenmenge. „queryResourceConsumption“ für die Zeile „Zusammenfassung“ und die Antworten ohne Zusammenfassung werden separat in den jeweiligen Zeilen zurückgegeben. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.