Method: customers.suggestBrands

Rpc untuk menampilkan daftar merek yang cocok berdasarkan awalan untuk pelanggan ini.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan tempat Anda akan menerapkan operasi saran merek.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Kolom
selectedBrands[]

string

Opsional. ID merek yang sudah dipilih oleh pengiklan. Sebagai tanggapan, item tersebut akan dikecualikan. Nilai ini diharapkan berupa ID merek, bukan nama merek.
brandPrefix

string

Wajib. Awalan nama merek.

Isi respons

Pesan respons untuk BrandSuggestionService.SuggestBrands.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Kolom
brands[]

object (BrandSuggestion)

Saran merek yang dihasilkan dari merek terverifikasi untuk awalan yang ditentukan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

BrandSuggestion

Informasi saran merek.

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

string

ID untuk merek. Atribut ini berupa CKG MID untuk merek terverifikasi/cakupan global.
name

string

Nama merek.
urls[]

string

URL yang mengidentifikasi merek secara unik.
state

enum (BrandState)

Status brand saat ini.