Method: customers.suggestBrands

透過 Rpc，根據這位客戶的前置碼傳回相符的品牌清單。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customerId

string

必要欄位。要套用品牌建議作業的客戶 ID。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
欄位
selectedBrands[]

string

選用設定。廣告主所選品牌的編號。因此不會包含在回應中。應為品牌 ID，而非品牌名稱。
brandPrefix

string

必要欄位。品牌名稱的前置字元。

回應主體

「BrandSuggestionService.SuggestBrands」的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
欄位
brands[]

object (BrandSuggestion)

針對指定前置字元，針對已驗證的品牌產生品牌建議。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。

BrandSuggestion

品牌建議的相關資訊。

JSON 表示法 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
欄位
id

string

品牌 ID。如果是已驗證/全域範圍的品牌，則為 CKG MID。
name

string

品牌名稱。
urls[]

string

可用來識別品牌的專屬網址。
state

enum (BrandState)

品牌目前的狀態。