Method: googleAdsFields.search

Gibt alle Felder zurück, die der Suchanfrage entsprechen.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError HeaderError InternalError QueryError QuotaError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v17/googleAdsFields:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "query": string,
  "pageToken": string,
  "pageSize": integer
}
Felder
query

string

Erforderlich. Abfragestring
pageToken

string

Token der abzurufenden Seite. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Verwenden Sie den Wert aus der vorherigen Antwort von nextPageToken, um die nächste Ergebnisseite anzufordern.
pageSize

integer

Anzahl der Elemente, die auf einer einzelnen Seite abgerufen werden sollen. Wenn eine zu große Seite angefordert wird, kann der Server die Anzahl der zurückgegebenen Ressourcen weiter begrenzen.

Antworttext

Antwortnachricht für GoogleAdsFieldService.SearchGoogleAdsFields.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "results": [
    {
      object (GoogleAdsField)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string
}
Felder
results[]

object (GoogleAdsField)

Die Liste der Felder, die der Abfrage entsprechen.
nextPageToken

string

Das Paginierungstoken, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Übergeben Sie den Inhalt dieses Strings als Attribut pageToken der nächsten Anfrage. Für die letzte Seite wird nextPageToken nicht zurückgegeben.
totalResultsCount

string (int64 format)

Gesamtzahl der Ergebnisse, die mit der Abfrage übereinstimmen, ohne die LIMIT-Klausel zu ignorieren.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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