REST Resource: accounts.brands

资源：品牌

品牌级图标和显示名称配置。获得批准后，图标和显示名称会显示在合作伙伴已分配给此品牌的房源的搜索结果中。

JSON 表示法 
{
  "name": string,
  "displayNames": [
    {
      object (LocalizedText)
    }
  ],
  "submittedDisplayNames": [
    {
      object (LocalizedText)
    }
  ],
  "activeDisplayNames": [
    {
      object (LocalizedText)
    }
  ],
  "displayNameState": enum (ReviewState),
  "displayNameDisapprovalReason": [
    {
      object (DisplayNameDisapprovalReason)
    }
  ],
  "icon": string,
  "submittedIcon": string,
  "activeIcon": string,
  "activeIconUri": string,
  "iconState": enum (ReviewState),
  "iconDisapprovalReasons": [
    enum (ImageDisapprovalReason)
  ],
  "propertyCount": string
}
字段
name

string

仅限输出。品牌的资源名称，格式为 accounts/{account_id}/brands/{brandId}。brandId 对应于用于着陆页匹配和媒体资源级品牌标识符的合作伙伴品牌标识符。

对于没有品牌的媒体资源，系统会应用默认品牌。默认品牌的 brandId 为 NO_BRAND_ID。可以像任何已配置的品牌一样提取和更新。
displayNames[]

object (LocalizedText)

仅限输入。Google 为品牌房源显示的名称。只有在您想替换品牌的着陆页显示名称或账号级显示名称时，才需要设置显示名称。Google 会审核显示名称，确保内容适宜。如果显示名称有多种语言版本，Google 只有在批准所有语言版本后才会显示这些名称。
submittedDisplayNames[]

object (LocalizedText)

仅限输出。品牌以所有提供的语言提交的显示名称，仅当显示名称是新名称或被任何语言拒绝时才存在。
activeDisplayNames[]

object (LocalizedText)

仅限输出。品牌在所有提供语言中的有效显示名称，仅当显示名称已获批用于所有提供语言时才会显示。
displayNameState

enum (ReviewState)

仅限输出。品牌的显示名称审核状态，适用于所有显示名称语言条目。如果同时存在已提交的显示名称和有效的显示名称，则此属性是指已提交的显示名称。
displayNameDisapprovalReason[]

object (DisplayNameDisapprovalReason)

仅限输出。显示名称的拒批原因。仅适用于审核状态为“REJECTED”的显示名称。
icon

string

仅限输入。品牌的 accounts.icon，用于标识品牌图标。该值是指图标的资源名称，格式为 accounts/{account_id}/icons/{icon_id}。
submittedIcon

string

仅限输出。品牌提交的 accounts.icon。该值是指图标的资源名称，格式为 accounts/{account_id}/icons/{icon_id}。已提交的图标是指新图标或被拒的图标。
activeIcon

string

仅限输出。品牌的有效accounts.icon。该值是指图标的资源名称，格式为 accounts/{account_id}/icons/{icon_id}。有效图标是指已获批准的图标。
activeIconUri

string

仅限输出。有效图标的网址，仅在图标已获批准时显示。
iconState

enum (ReviewState)

仅限输出。品牌图标的审核状态。如果同时存在已提交和有效图标，则指已提交图标。
iconDisapprovalReasons[]

enum (ImageDisapprovalReason)

仅限输出。相应图标的拒登原因。仅适用于处于 REJECTED 状态的已提交图标。
propertyCount

string (int64 format)

仅限输出。具有相应品牌 ID 的房源数量。

ReviewState

关联图标或显示名称的可能审核状态。

枚举
REVIEW_STATE_UNSPECIFIED 默认值。
REVIEW_STATE_NEW Google 正在审核相应图标或显示名称。
APPROVED 图标或显示名称已获批准，可以公开显示。
REJECTED 图标或显示名称被拒。Google 不会显示此信息。

DisplayNameDisapprovalReason

特定语言的显示名称的遭拒原因。

JSON 表示法 
{
  "languageCode": string,
  "disapprovalReason": enum (DisapprovalReason)
}
字段
languageCode

string

被拒批的显示名称所用的语言。
disapprovalReason

enum (DisapprovalReason)

拒登原因。

DisapprovalReason

显示名称遭拒的可能原因。

枚举
DISAPPROVAL_REASON_UNSPECIFIED 未指定。
PUNCTUATION 显示名称的格式有误和/或包含标点符号。
MARKETING_LANGUAGE 显示名称包含营销语言。
LANDING_PAGE_NOT_MATCHED 显示名称与着陆页不一致。
NOT_BRAND_NAME 此显示名称看起来不像是一个品牌。

方法

create

 创建新品牌。

get

 返回与请求 URI 的品牌资源名称关联的 Brand 实例。

list

 返回合作伙伴账号的品牌。

patch

 更新品牌。