Rpc,用于根据此客户的前缀返回匹配品牌的列表。
HTTP 请求
POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。要对其应用品牌建议操作的客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "selectedBrands": [ string ], "brandPrefix": string } |
字段 | |
---|---|
selectedBrands[] |
可选。广告客户已选择的品牌的 ID。回复时,系统会将其排除。这些应是品牌 ID,而不是品牌名称。 |
brandPrefix |
必需。品牌名称的前缀。 |
响应正文
BrandSuggestionService.SuggestBrands
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"brands": [
{
object ( |
字段 | |
---|---|
brands[] |
针对指定前缀生成经过验证的品牌的品牌建议。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
BrandSuggestion
品牌建议的信息。
JSON 表示法 |
---|
{
"id": string,
"name": string,
"urls": [
string
],
"state": enum ( |
字段 | |
---|---|
id |
品牌的 ID。对于经过验证的/全球范围的品牌,则为 CKG MID。 |
name |
品牌名称。 |
urls[] |
用于唯一标识品牌的网址。 |
state |
品牌的当前状态。 |
BrandState
不同品牌状态的枚举。
枚举 | |
---|---|
UNSPECIFIED |
尚未指定任何值。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
ENABLED |
品牌已经过验证,可在全球范围内选择 |
DEPRECATED |
品牌过去在全球范围内提供,但不再是有效品牌(根据业务标准) |
UNVERIFIED |
品牌未经验证,且限定为客户范围,但可由客户选择(仅限提出请求的客户)进行定位 |
APPROVED |
是客户范围(未经验证)的品牌,已获得商家批准并已添加到全局列表中。应使用分配的 CKG MID,而非此 |
CANCELLED |
是客户范围(未验证)的品牌,但请求已被客户取消,此品牌 ID 不再有效 |
REJECTED |
是客户范围(未经验证)的品牌,但请求被内部业务团队拒绝,并且此品牌 ID 不再有效 |