Method: customers.suggestBrands

Rpc, aby zwrócić listę pasujących marek na podstawie prefiksu dla tego klienta.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Wymagane. Identyfikator klienta, do którego należy zastosować operację sugerowania marki.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Pola
selectedBrands[]

string

Opcjonalnie. Identyfikatory marek już wybranych przez reklamodawców. W odpowiedzi zostaną one wykluczone. Mają to być identyfikatory marek, a nie nazwy marek.
brandPrefix

string

Wymagane. Prefiks nazwy marki.

Treść odpowiedzi

Odpowiedź na pytanie: BrandSuggestionService.SuggestBrands.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Pola
brands[]

object (BrandSuggestion)

Wygenerowane sugestie zweryfikowanych marek dla danego prefiksu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

BrandSuggestion

Informacje dotyczące sugestii marki.

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

string

Identyfikator marki. W przypadku zweryfikowanych lub globalnych marek będzie to CKG MID.
name

string

Nazwa marki.
urls[]

string

Adresy URL, które jednoznacznie identyfikują markę.
state

enum (BrandState)

Obecny stan marki.