Method: customers.suggestBrands

Rpc，用于根据此客户的前缀返回匹配品牌的列表。

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 不再有效