Method: customers.suggestBrands

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, do którego ma zostać zastosowana operacja 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. Powinny to być identyfikatory marek, a nie nazwy marek.
brandPrefix

string

To pole jest wymagane. Prefiks nazwy marki.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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 dotyczące zweryfikowanych marek dla podanego prefiksu.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie 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/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.

BrandState

Wyliczenie różnych stanów marki.

Wartości w polu enum
UNSPECIFIED Nie określono wartości.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Marka została zweryfikowana i jest dostępna do wyboru na całym świecie
DEPRECATED Marka była w przeszłości dostępna globalnie, ale nie jest już prawidłową marką (na podstawie kryteriów biznesowych)
UNVERIFIED Marka jest niezweryfikowana i ma ograniczony zakres do klienta, ale klient może ją wybrać do kierowania (tylko te osoby, które o to prosiły).
APPROVED Była niezweryfikowana marka ograniczona do klienta, która została zatwierdzona przez firmę i dodana do listy globalnej. Zamiast tego należy użyć przypisanego identyfikatora CKG MID
CANCELLED Marka była ograniczona do klienta (niezweryfikowana), ale prośba została anulowana przez klienta, a ten identyfikator marki jest już nieważny
REJECTED Marka była ograniczona do klienta (niezweryfikowana), ale prośba została odrzucona przez wewnętrzny zespół biznesowy, a ten identyfikator marki jest już nieważny