Gibt alle Zeilen zurück, die der Suchanfrage entsprechen.
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:search
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
customerId |
Erforderlich. Die ID des abgefragten Kunden. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"query": string,
"pageToken": string,
"pageSize": integer,
"validateOnly": boolean,
"returnTotalResultsCount": boolean,
"summaryRowSetting": enum ( |
Felder | |
---|---|
query |
Erforderlich. Der Abfragestring. |
pageToken |
Token der abzurufenden Seite. Wenn nicht angegeben, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert von |
pageSize |
Anzahl der Elemente, die auf einer einzelnen Seite abgerufen werden sollen. Wenn eine zu große Seite angefordert wird, entscheidet der Server unter Umständen, die Anzahl der zurückgegebenen Ressourcen weiter zu begrenzen. |
validateOnly |
Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. |
returnTotalResultsCount |
Bei „true“ wird die Gesamtzahl der Ergebnisse, die mit der Abfrage übereinstimmen und die LIMIT-Klausel ignorieren, in die Antwort aufgenommen. Der Standardwert ist "false". |
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.Search
.
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. |
nextPageToken |
Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Übergeben Sie den Inhalt dieses Strings als |
totalResultsCount |
Gesamtzahl der Ergebnisse, die mit der Abfrage übereinstimmen, wobei die LIMIT-Klausel ignoriert wird. |
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 von Metriken werden die Metriken für alle Ergebnisse zusammengefasst. Die Aggregation kann in diesem Fall Summe, Durchschnitt, Rate usw. sein. |
queryResourceConsumption |
Die Menge an Ressourcen, die zum Ausführen der Abfrage verbraucht wurden. |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/adwords
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.