Method: geoTargetConstants.suggest

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

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

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/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

Die zurückgegebenen geografischen Ziele werden nach Möglichkeit 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. Ein Selektor für geografische Ausrichtungskonstanten 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 der geografischen Ausrichtung, 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 Konstanten für die geografische Ausrichtung.

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 Namen konstanter Ressourcen für die geografische Ausrichtung.

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

string

Eine Liste der Namen konstanter Ressourcen für die geografische Ausrichtung.

GeoTargetConstantSuggestion

Ein Vorschlag für eine Konstante für die 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)

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

string

Die Sprache, in die dieser GeoTargetConstantSelector derzeit übersetzt ist Sie wirkt sich auf den Namen der Felder für die geografische Ausrichtung aus. Beispiel: Bei Eingabe von Gebietsschema=de, dann Name=Spanien. Wenn Gebietsschema=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 Zielnutzerpopulation, gerundet auf die nächsten 100.
searchTerm

string

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