Method: customers.suggestBrands

根據此客戶的前置字元，傳回相符的品牌清單。

HTTP 要求

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

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

路徑參數

參數
customerId

string

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

要求主體

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

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

string

選用設定。廣告主所選品牌的 ID。因此會在回應中排除。輸入的值應為品牌 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)

品牌目前的狀態。

BrandState

列舉不同的品牌狀態。

列舉
UNSPECIFIED 未指定任何值。
UNKNOWN 僅適用於傳回值。代表此版本中未知的值。
ENABLED 品牌已通過驗證，可在全球選取
DEPRECATED 品牌過去在全球提供服務，但不再是有效的品牌 (根據業務條件)
UNVERIFIED 品牌未經驗證且以客戶為範圍，但客戶可選取 (僅限要求相同者) 來指定目標
APPROVED 屬於客戶範圍 (未驗證) 品牌，經商家核准並加入全球清單中。應使用指派的 CKG MID，而不是這個
CANCELLED 該品牌屬於客戶範圍 (未驗證) 品牌，但客戶取消了要求，且這個品牌 ID 已失效
REJECTED 本身是以客戶為範圍 (未驗證) 的品牌，但內部業務團隊拒絕了要求，且這個品牌 ID 已失效