Method: customers.suggestBrands

Rpc per restituire un elenco di brand corrispondenti in base a un prefisso per questo cliente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatoria. L'ID del cliente a cui applicare l'operazione di suggerimento di brand.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Campi
selectedBrands[]

string

Campo facoltativo. ID dei brand già selezionati dagli inserzionisti. Verranno esclusi nella risposta. Si tratta di ID brand, non di nomi di brand.

brandPrefix

string

Obbligatoria. Il prefisso del nome di un brand.

Corpo della risposta

Messaggio di risposta per BrandSuggestionService.SuggestBrands.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Campi
brands[]

object (BrandSuggestion)

Sono stati generati suggerimenti di brand di brand verificati per il prefisso specificato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

BrandSuggestion

Informazioni del suggerimento di brand.

Rappresentazione JSON
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Campi
id

string

ID del brand. Sarà CKG MID per brand con ambito verificato/globale.

name

string

Nome del brand.

urls[]

string

URL che identificano in modo univoco il brand.

state

enum (BrandState)

Stato attuale del brand.