REST Resource: accounts.brands

Tài nguyên: Thương hiệu

Cấu hình biểu tượng và tên hiển thị ở cấp thương hiệu. Sau khi được phê duyệt, biểu tượng và tên hiển thị sẽ xuất hiện trong kết quả tìm kiếm cho những cơ sở lưu trú mà đối tác đã chỉ định cho thương hiệu này.

Biểu diễn dưới dạng 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
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên của thương hiệu ở định dạng accounts/{account_id}/brands/{brandId}. brandId tương ứng với giá trị nhận dạng thương hiệu của đối tác dùng để so khớp trang đích và giá trị nhận dạng thương hiệu ở cấp tài sản.

Một thương hiệu mặc định được áp dụng cho những cơ sở lưu trú không có thương hiệu. brandId của thương hiệu mặc định là NO_BRAND_ID. Bạn có thể tìm nạp và cập nhật thương hiệu này như mọi thương hiệu đã định cấu hình.

displayNames[]

object (LocalizedText)

Chỉ có đầu vào. Tên mà Google hiển thị cho các cơ sở lưu trú của thương hiệu. Bạn chỉ cần thiết lập tên hiển thị nếu muốn ghi đè tên hiển thị của trang đích hoặc tên hiển thị ở cấp tài khoản cho thương hiệu. Google xem xét tên hiển thị để đảm bảo nội dung phù hợp. Khi có nhiều ngôn ngữ, Google sẽ chỉ hiển thị tên hiển thị sau khi Google phê duyệt tất cả các ngôn ngữ.

submittedDisplayNames[]

object (LocalizedText)

Chỉ có đầu ra. Tên hiển thị mà thương hiệu đã gửi bằng tất cả các ngôn ngữ được cung cấp, chỉ xuất hiện nếu tên hiển thị là tên mới hoặc bị từ chối đối với bất kỳ ngôn ngữ nào.

activeDisplayNames[]

object (LocalizedText)

Chỉ có đầu ra. Tên hiển thị đang hoạt động của thương hiệu bằng tất cả các ngôn ngữ được cung cấp, chỉ xuất hiện nếu tên hiển thị được phê duyệt cho tất cả các ngôn ngữ được cung cấp.

displayNameState

enum (ReviewState)

Chỉ có đầu ra. Trạng thái xem xét tên hiển thị của thương hiệu, áp dụng cho tất cả mục nhập ngôn ngữ tên hiển thị. Nếu có cả tên hiển thị đã gửi và tên hiển thị đang hoạt động, thì điều này đề cập đến tên hiển thị đã gửi.

displayNameDisapprovalReason[]

object (DisplayNameDisapprovalReason)

Chỉ có đầu ra. Lý do tên hiển thị bị từ chối. Chỉ áp dụng cho tên hiển thị có trạng thái xem xét là "BỊ TỪ CHỐI".

icon

string

Chỉ có đầu vào. accounts.icon của thương hiệu xác định biểu tượng của thương hiệu. Giá trị này đề cập đến tên tài nguyên của biểu tượng ở định dạng accounts/{account_id}/icons/{icon_id}.

submittedIcon

string

Chỉ có đầu ra. accounts.icon mà thương hiệu đã gửi. Giá trị này đề cập đến tên tài nguyên của biểu tượng ở định dạng accounts/{account_id}/icons/{icon_id}. Biểu tượng đã gửi là biểu tượng mới hoặc bị từ chối.

activeIcon

string

Chỉ có đầu ra. accounts.icon Tài khoản đang hoạt động của thương hiệu. Giá trị này đề cập đến tên tài nguyên của biểu tượng ở định dạng accounts/{account_id}/icons/{icon_id}. Biểu tượng đang hoạt động là biểu tượng đã được phê duyệt.

activeIconUri

string

Chỉ có đầu ra. URL của biểu tượng đang hoạt động, chỉ xuất hiện khi biểu tượng đã được phê duyệt.

iconState

enum (ReviewState)

Chỉ có đầu ra. Trạng thái xem xét biểu tượng của thương hiệu. Nếu có cả biểu tượng đã gửi và biểu tượng đang hoạt động, thì điều này có nghĩa là biểu tượng đã gửi.

iconDisapprovalReasons[]

enum (ImageDisapprovalReason)

Chỉ có đầu ra. (Các) lý do biểu tượng bị từ chối. Chỉ áp dụng cho các biểu tượng đã gửi có trạng thái REJECTED.

propertyCount

string (int64 format)

Chỉ có đầu ra. Số lượng cơ sở lưu trú có mã thương hiệu tương ứng.

ReviewState

Các trạng thái xem xét có thể có cho biểu tượng hoặc tên hiển thị được liên kết.

Enum
REVIEW_STATE_UNSPECIFIED Giá trị mặc định.
REVIEW_STATE_NEW Google đang xem xét biểu tượng hoặc tên hiển thị.
APPROVED Biểu tượng hoặc tên hiển thị được phê duyệt và sẵn sàng xuất hiện công khai.
REJECTED Biểu tượng hoặc tên hiển thị bị từ chối. Google sẽ không hiển thị thông tin này.

DisplayNameDisapprovalReason

Lý do tên hiển thị bị từ chối bằng một ngôn ngữ cụ thể.

Biểu diễn dưới dạng JSON
{
  "languageCode": string,
  "disapprovalReason": enum (DisapprovalReason)
}
Trường
languageCode

string

Ngôn ngữ của tên hiển thị bị từ chối.

disapprovalReason

enum (DisapprovalReason)

Lý do từ chối.

DisapprovalReason

Những lý do có thể khiến tên hiển thị bị từ chối.

Enum
DISAPPROVAL_REASON_UNSPECIFIED Chưa chỉ định.
PUNCTUATION Tên hiển thị có định dạng sai và/hoặc chứa dấu câu.
MARKETING_LANGUAGE Tên hiển thị có chứa ngôn từ tiếp thị.
LANDING_PAGE_NOT_MATCHED Tên hiển thị không khớp với trang đích.
NOT_BRAND_NAME Tên hiển thị này có vẻ không phải là một thương hiệu.

Phương thức

create

Tạo một thương hiệu mới.

get

Trả về thực thể Brand được liên kết với tên tài nguyên thương hiệu của URI yêu cầu.

list

Trả về các thương hiệu cho một tài khoản đối tác.

patch

Cập nhật một thương hiệu.