Method: customers.suggestBrands

„Rpc“, um eine Liste übereinstimmender Marken basierend auf einem Präfix für diesen Kunden zurückzugeben.

HTTP-Anfrage

POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, auf die der Markenvorschlagsvorgang angewendet werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Felder
selectedBrands[]

string

Optional. IDs der Marken, die bereits von Werbetreibenden ausgewählt wurden. Sie werden als Antwort ausgeschlossen. Dabei muss es sich um Marken-IDs und nicht um Markennamen handeln.
brandPrefix

string

Erforderlich. Das Präfix eines Markennamens.

Antworttext

Antwortnachricht für BrandSuggestionService.SuggestBrands.

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

JSON-Darstellung 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Felder
brands[]

object (BrandSuggestion)

Markenvorschläge verifizierter Marken für das angegebene Präfix generiert.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

BrandSuggestion

Informationen zum Markenvorschlag.

JSON-Darstellung 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Felder
id

string

ID der Marke. Für bestätigte/globale Marken wäre die CKG-MID.
name

string

Name der Marke.
urls[]

string

URLs, die die Marke eindeutig identifizieren.
state

enum (BrandState)

Aktueller Zustand der Marke.

BrandState

Aufzählung verschiedener Markenzustände.

Enums
UNSPECIFIED Es wurde kein Wert angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
ENABLED Die Marke ist verifiziert und kann weltweit ausgewählt werden
DEPRECATED Die Marke war in der Vergangenheit weltweit verfügbar, ist aber aufgrund von Unternehmenskriterien keine gültige Marke mehr
UNVERIFIED Die Marke ist nicht bestätigt und auf Kundenebene, kann aber vom Kunden (nur der Nutzer, der dies angefordert hat) für das Targeting ausgewählt werden
APPROVED Es war eine Marke auf Kundenebene (nicht bestätigt), die vom Unternehmen genehmigt und der globalen Liste hinzugefügt wurde. Die zugewiesene CKG-MID sollte anstelle dieser ID verwendet werden.
CANCELLED Es war eine Marke auf Kundenebene (nicht bestätigt), aber die Anfrage wurde vom Kunden abgebrochen und diese Marken-ID ist nicht mehr gültig
REJECTED Es war eine Marke auf Kundenebene (nicht bestätigt), aber die Anfrage wurde vom internen Business-Team abgelehnt und diese Marken-ID ist nicht mehr gültig