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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. 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 in risposta. Questi devono essere ID brand, non nomi di brand.
brandPrefix

string

Obbligatorio. 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 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 i brand con ambito verificato/globale.
name

string

Il nome del brand.
urls[]

string

URL che identificano in modo univoco il brand.
state

enum (BrandState)

Stato attuale del brand.

BrandState

Enumerazione dei diversi stati del brand.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ENABLED Il brand è verificato e disponibile per la selezione a livello globale
DEPRECATED Il brand era disponibile a livello globale in passato, ma non è più un brand valido (in base ai criteri aziendali)
UNVERIFIED Il brand non è verificato ed è limitato all'ambito dei clienti, ma può essere selezionato dal cliente (solo che lo ha richiesto) per il targeting
APPROVED Era un brand basato sui clienti (non verificato), che è stato approvato dall'attività e aggiunto all'elenco globale. Il MID CKG assegnato deve essere utilizzato al posto di questo
CANCELLED Era un brand con ambito cliente (non verificato), ma la richiesta è stata annullata dal cliente e questo ID brand non è più valido
REJECTED Era un brand basato sui clienti (non verificato), ma la richiesta è stata rifiutata dal team aziendale interno e questo ID brand non è più valido