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/v16/customers/{customerId}:suggestBrands

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, auf den 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)

Es wurden 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 CKG MID.
name

string

Name der Marke.
urls[]

string

URLs, die die Marke eindeutig identifizieren.
state

enum (BrandState)

Aktueller Zustand der Marke.