Method: customers.suggestBrands

Rpc để trả về danh sách các thương hiệu phù hợp dựa trên tiền tố cho khách hàng này.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

Bắt buộc. Mã nhận dạng của khách hàng để áp dụng thao tác đề xuất thương hiệu.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Các trường
selectedBrands[]

string

Không bắt buộc. Mã nhận dạng của những thương hiệu mà nhà quảng cáo đã chọn. Trong phản hồi, họ sẽ bị loại trừ. Đây là những mã thương hiệu chứ không phải tên thương hiệu.
brandPrefix

string

Bắt buộc. Tiền tố của một tên thương hiệu.

Nội dung phản hồi

Tin nhắn trả lời cho BrandSuggestionService.SuggestBrands.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Các trường
brands[]

object (BrandSuggestion)

Các đề xuất về thương hiệu đã tạo của các thương hiệu đã xác minh cho tiền tố cụ thể.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

BrandSuggestion

Thông tin về đề xuất về thương hiệu.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Các trường
id

string

Mã nhận dạng của thương hiệu. Đó sẽ là CKG MID cho các thương hiệu đã xác minh/có phạm vi toàn cầu.
name

string

Tên thương hiệu.
urls[]

string

URL nhận dạng duy nhất thương hiệu.
state

enum (BrandState)

Tình trạng hiện tại của thương hiệu.

BrandState

Liệt kê các trạng thái thương hiệu khác nhau.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Thương hiệu đã được xác minh và có thể lựa chọn trên toàn cầu
DEPRECATED Thương hiệu đã có mặt trên toàn cầu nhưng không còn là thương hiệu hợp lệ (dựa trên tiêu chí về kinh doanh)
UNVERIFIED Thương hiệu chưa được xác minh và thuộc phạm vi khách hàng, nhưng có thể được khách hàng (chỉ những người đã yêu cầu đối tượng tương tự) chọn để nhắm mục tiêu
APPROVED Từng là một thương hiệu tập trung vào khách hàng (chưa được xác minh), đã được doanh nghiệp phê duyệt và được thêm vào danh sách toàn cầu. Bạn nên sử dụng CKG MID được chỉ định của nhóm này thay vì
CANCELLED Từng là một thương hiệu hoạt động trong phạm vi khách hàng (chưa được xác minh), nhưng khách hàng đã huỷ yêu cầu và mã thương hiệu này không còn hợp lệ
REJECTED Từng là một thương hiệu hoạt động trong phạm vi khách hàng (chưa được xác minh), nhưng nhóm kinh doanh nội bộ đã từ chối yêu cầu và mã thương hiệu này không còn hợp lệ