REST Resource: accounts.brands

資源：Brand

品牌層級的圖示和顯示名稱設定。通過核准後，合作夥伴指派給這個品牌的房源，就會在搜尋結果中顯示圖示和顯示名稱。

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 對應至合作夥伴的品牌 ID，用於比對到達網頁和資源層級的品牌 ID。

如果房源沒有品牌，系統會套用預設品牌。預設品牌的 brandId 為 NO_BRAND_ID。與任何已設定的品牌一樣，可以擷取及更新。
displayNames[]

object (LocalizedText)

僅限輸入。Google 為品牌房源顯示的名稱。只有在想覆寫品牌的到達網頁顯示名稱或帳戶層級顯示名稱時，才需要設定顯示名稱。Google 會審查顯示名稱，確保內容適當。如果有多種語言，Google 必須先核准所有語言，才會顯示顯示名稱。
submittedDisplayNames[]

object (LocalizedText)

僅供輸出。品牌在所有提供語言中提交的顯示名稱，只有在顯示名稱為新名稱或遭拒時才會顯示。
activeDisplayNames[]

object (LocalizedText)

僅供輸出。品牌在所有提供語言中的有效顯示名稱，只有在所有提供語言的顯示名稱都獲得核准時才會顯示。
displayNameState

enum (ReviewState)

僅供輸出。品牌的顯示名稱審查狀態，適用於所有顯示名稱語言項目。如果已提交和使用中的顯示名稱都有，則是指已提交的顯示名稱。
displayNameDisapprovalReason[]

object (DisplayNameDisapprovalReason)

僅供輸出。顯示名稱遭拒的原因。僅適用於審查狀態為「已拒絕」的顯示名稱。
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

 更新品牌。