Method: customers.suggestBrands

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

Permintaan HTTP

POST https://googleads.googleapis.com/v15/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, mereka akan dikecualikan. ID merek adalah 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. Nilainya adalah CKG MID untuk merek terverifikasi/cakupan global.
name

string

Nama brand.
urls[]

string

URL yang mengidentifikasi merek secara unik.
state

enum (BrandState)

Status merek saat ini.

BrandState

Enumerasi berbagai status merek.

Enum
UNSPECIFIED Tidak ada nilai yang ditentukan.
UNKNOWN Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini.
ENABLED Merek telah diverifikasi dan tersedia secara global untuk dipilih
DEPRECATED Merek sebelumnya tersedia secara global, tetapi bukan lagi merek yang valid (berdasarkan kriteria bisnis)
UNVERIFIED Merek belum diverifikasi dan memiliki cakupan pelanggan, tetapi dapat dipilih oleh pelanggan (hanya yang meminta yang sama) untuk penargetan
APPROVED Memiliki merek dengan cakupan pelanggan (belum terverifikasi), yang disetujui oleh bisnis dan ditambahkan ke daftar global. MID CKG yang ditetapkan harus digunakan sebagai pengganti
CANCELLED Merupakan merek dengan cakupan pelanggan (belum diverifikasi), tetapi permintaan dibatalkan oleh pelanggan dan ID merek ini tidak valid lagi
REJECTED Merupakan merek dengan cakupan pelanggan (belum diverifikasi), tetapi permintaan ditolak oleh tim bisnis internal dan ID merek ini tidak lagi valid