Method: geoTargetConstants.suggest

Gibt GeoTargetConstant-Vorschläge nach Standortnamen oder Ressourcennamen zurück

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError GeoTargetConstantSuggestionError HeaderError InternalError QuotaError RequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v16/geoTargetConstants:suggest

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "locale": string,
  "countryCode": string,

  // Union field query can be only one of the following:
  "locationNames": {
    object (LocationNames)
  },
  "geoTargets": {
    object (GeoTargets)
  }
  // End of list of possible types for union field query.
}
Felder
locale

string

Wenn möglich, werden zurückgegebene geografische Ziele in diese Sprache übersetzt. Andernfalls wird standardmäßig „en“ verwendet. Dies wird auch als Hinweis für zurückgegebene geografische Ziele verwendet.
countryCode

string

Die zurückgegebenen geografischen Ziele sind auf diesen Ländercode beschränkt.
Union-Feld query. Erforderlich. Auswahl der Konstanten für die geografische Ausrichtung Für query ist nur einer der folgenden Werte zulässig:
locationNames

object (LocationNames)

Die Namen der Orte, nach denen gesucht werden soll. Es können maximal 25 Namen festgelegt werden.
geoTargets

object (GeoTargets)

Die konstanten Ressourcennamen des geografischen Ziels, nach denen gefiltert werden soll.

Antworttext

Antwortnachricht für GeoTargetConstantService.SuggestGeoTargetConstants.

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

JSON-Darstellung 
{
  "geoTargetConstantSuggestions": [
    {
      object (GeoTargetConstantSuggestion)
    }
  ]
}
Felder
geoTargetConstantSuggestions[]

object (GeoTargetConstantSuggestion)

Vorschläge für die geografische Ausrichtungskonstante.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

LocationNames

Eine Liste mit Standortnamen.

JSON-Darstellung 
{
  "names": [
    string
  ]
}
Felder
names[]

string

Eine Liste mit Standortnamen.

GeoTargets

Eine Liste der konstanten Ressourcennamen für die geografische Ausrichtung

JSON-Darstellung 
{
  "geoTargetConstants": [
    string
  ]
}
Felder
geoTargetConstants[]

string

Eine Liste der konstanten Ressourcennamen für die geografische Ausrichtung

GeoTargetConstantSuggestion

Ein Vorschlag für eine konstante geografische Ausrichtung.

JSON-Darstellung 
{
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "geoTargetConstantParents": [
    {
      object (GeoTargetConstant)
    }
  ],
  "locale": string,
  "reach": string,
  "searchTerm": string
}
Felder
geoTargetConstant

object (GeoTargetConstant)

Das GeoTargetConstant-Ergebnis.
geoTargetConstantParents[]

object (GeoTargetConstant)

Liste der übergeordneten Elemente der Konstante für die geografische Ausrichtung
locale

string

Sprache, in die dieses GeoTargetConstantSuggestion-Element derzeit übersetzt ist Sie wirkt sich auf den Namen der Felder für die geografische Ausrichtung aus. Beispiel: Bei Gebietsschema=en wird Name=Spanien. Wenn Sprache=es, dann name=España. Die Standardsprache wird zurückgegeben, wenn für die Sprache in der Anfrage keine Übersetzung vorhanden ist.
reach

string (int64 format)

Ungefähre Zielgruppe für die Ausrichtung, gerundet auf die nächsten 100.
searchTerm

string

Wenn in der Anfrage nach dem Standortnamen gesucht wird, ist dies der Name, der mit dem geografischen Ziel übereinstimmt.