REST Resource: genericobject

Tài nguyên: GenericObject

Mã nhận dạng tiếp theo của đối tượng chung: 121

Biểu diễn dưới dạng JSON 
{
  "genericType": enum (GenericType),
  "cardTitle": {
    object (LocalizedString)
  },
  "subheader": {
    object (LocalizedString)
  },
  "header": {
    object (LocalizedString)
  },
  "logo": {
    object (Image)
  },
  "hexBackgroundColor": string,
  "notifications": {
    object (Notifications)
  },
  "id": string,
  "classId": string,
  "barcode": {
    object (Barcode)
  },
  "heroImage": {
    object (Image)
  },
  "validTimeInterval": {
    object (TimeInterval)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "smartTapRedemptionValue": string,
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "state": enum (State),
  "hasUsers": boolean,
  "passConstraints": {
    object (PassConstraints)
  },
  "wideLogo": {
    object (Image)
  }
}
Trường
genericType

enum (GenericType)

Chỉ định GenericType chứa thẻ.
cardTitle

object (LocalizedString)

Bắt buộc. Tiêu đề của thẻ/vé. Đây thường là Tên doanh nghiệp, chẳng hạn như "XXX phòng tập", "Bảo hiểm AAA". Trường này là trường bắt buộc và xuất hiện trong hàng tiêu đề ở phía trên cùng của thẻ.
subheader

object (LocalizedString)

Nhãn tiêu đề của thẻ/vé, chẳng hạn như vị trí có thể sử dụng thẻ/vé này. Xuất hiện ngay phía trên tiêu đề trong hàng tiêu đề trong chế độ xem chi tiết thẻ và vé.
header

object (LocalizedString)

Bắt buộc. Tiêu đề của thẻ/vé, chẳng hạn như "Phiếu giảm giá 50%" hoặc "Thẻ thư viện" hoặc "Phiếu thưởng". Đây là trường bắt buộc và sẽ xuất hiện trong hàng tiêu đề của chế độ xem chi tiết thẻ/vé.
hexBackgroundColor

string

Màu nền cho thẻ. Nếu bạn không đặt biểu trưng, thì màu chủ đạo của hình ảnh chính sẽ được sử dụng. Nếu bạn không đặt hình ảnh chính, thì màu chủ đạo của biểu trưng sẽ được sử dụng. Nếu bạn không đặt biểu trưng, Google sẽ chọn màu sắc.
notifications

object (Notifications)

Các tùy chọn cài đặt thông báo đã bật cho đối tượng này.
id

string

Bắt buộc. Giá trị nhận dạng duy nhất của một đối tượng. Mã nhận dạng này phải là mã duy nhất trên tất cả các đối tượng của một nhà phát hành. Giá trị này cần phải tuân theo định dạng issuerID.identifier, trong đó issuerID do Google phát hành còn identifier là do bạn chọn. Giá trị nhận dạng duy nhất chỉ có thể bao gồm ký tự chữ-số, ., _ hoặc -.
classId

string

Bắt buộc. Lớp liên kết với đối tượng này. Lớp phải thuộc cùng loại với đối tượng này, phải tồn tại và phải được phê duyệt.

Mã lớp phải theo định dạng issuerID.identifier, trong đó issuerID do Google cấp còn bạn là người chọn identifier.
barcode

object (Barcode)

Loại và giá trị mã vạch. Nếu thẻ/vé không có mã vạch, chúng tôi có thể cho phép công ty phát hành mã đặt Barcode.alternate_text và chỉ cho thấy mã đó.
heroImage

object (Image)

Hình ảnh biểu ngữ hiển thị ở mặt trước của thẻ, nếu có. Hình ảnh sẽ hiển thị với chiều rộng 100%.
validTimeInterval

object (TimeInterval)

Khoảng thời gian mà đối tượng này sẽ được coi là hợp lệ hoặc có thể sử dụng được. Khi khoảng thời gian này được trôi qua, đối tượng sẽ được coi là đã hết hạn. Điều này sẽ ảnh hưởng đến việc hiển thị trên thiết bị của người dùng.
imageModulesData[]

object (ImageModuleData)

Dữ liệu mô-đun hình ảnh. Khi đặt cả hai hình ảnh, hệ thống sẽ chỉ kết xuất một hình ảnh ở lớp và một hình ảnh ở cấp đối tượng.
textModulesData[]

object (TextModuleData)

Dữ liệu mô-đun văn bản. Nếu textModulesData cũng được xác định trên lớp, thì cả hai sẽ hiển thị. Số lượng tối đa các trường này hiển thị là 10 cho lớp và 10 trường cho đối tượng.
groupingInfo

object (GroupingInfo)

Thông tin kiểm soát cách nhóm các thẻ và vé lại với nhau.
smartTapRedemptionValue

string

Giá trị sẽ được truyền đến thiết bị đầu cuối được chứng nhận Chạm thông minh qua NFC cho đối tượng này. Bạn cũng phải thiết lập các trường cấp lớp enableSmartTap và redemptionIssuers đúng cách để thẻ/vé hỗ trợ tính năng Chạm thông minh. Chỉ hỗ trợ các ký tự ASCII.
rotatingBarcode

object (RotatingBarcode)

Cài đặt/thông tin chi tiết về mã vạch xoay.
state

enum (State)

Trạng thái của đối tượng. Trường này dùng để xác định cách một đối tượng xuất hiện trong ứng dụng. Ví dụ: một đối tượng inactive được di chuyển đến mục "Thẻ và vé đã hết hạn". Nếu bạn không cung cấp thuộc tính này, đối tượng sẽ được coi là ACTIVE.
hasUsers

boolean

Cho biết đối tượng có người dùng hay không. Trường này do nền tảng đặt.
passConstraints

object (PassConstraints)

Truyền các quy tắc ràng buộc cho đối tượng. Bao gồm cả việc giới hạn NFC và hành vi chụp ảnh màn hình.

GenericType

Loại thẻ chung.

Enum
GENERIC_TYPE_UNSPECIFIED Kiểu chung không xác định.
GENERIC_SEASON_PASS Vé xem theo mùa
GENERIC_UTILITY_BILLS Hoá đơn dịch vụ tiện ích
GENERIC_PARKING_PASS Thẻ đỗ xe
GENERIC_VOUCHER Phiếu thưởng
GENERIC_GYM_MEMBERSHIP Thẻ thành viên phòng tập thể dục
GENERIC_LIBRARY_MEMBERSHIP Thẻ thành viên thư viện
GENERIC_RESERVATIONS Lưu trữ
GENERIC_AUTO_INSURANCE Thẻ bảo hiểm ô tô
GENERIC_HOME_INSURANCE Thẻ bảo hiểm nhà ở
GENERIC_ENTRY_TICKET Vé vào cửa
GENERIC_RECEIPT Biên nhận
GENERIC_OTHER Loại khác

Thông báo

Cho biết liệu đối tượng có cần bật thông báo hay không. Chúng tôi chỉ hỗ trợ một trong các trường hợp sau ExpiryNotification/UnsubscribeNotification. expiryNotification được ưu tiên hơn upcomingNotification. Nói cách khác, nếu bạn đặt expiryNotification, chúng ta sẽ bỏ qua trường upcomingNotification.

Biểu diễn dưới dạng JSON 
{
  "expiryNotification": {
    object (ExpiryNotification)
  },
  "upcomingNotification": {
    object (UpcomingNotification)
  }
}
Trường
expiryNotification

object (ExpiryNotification)

Một thông báo sẽ được kích hoạt vào một thời điểm cụ thể trước khi thẻ hết hạn.
upcomingNotification

object (UpcomingNotification)

Một thông báo sẽ được kích hoạt vào một thời điểm cụ thể trước khi thẻ có thể sử dụng được.

ExpiryNotification

Cho biết rằng tổ chức phát hành muốn Google Wallet gửi thông báo về ngày hết hạn 2 ngày trước khi thẻ hết hạn.

Biểu diễn dưới dạng JSON 
{
  "enableNotification": boolean
}
Trường
enableNotification

boolean

Cho biết liệu đối tượng có cần bật thông báo hết hạn hay không.

UpcomingNotification

Cho biết rằng tổ chức phát hành muốn Google Wallet gửi thông báo về tính hợp lệ của thẻ 1 ngày trước khi thẻ hợp lệ/có thể sử dụng được.

Biểu diễn dưới dạng JSON 
{
  "enableNotification": boolean
}
Trường
enableNotification

boolean

Cho biết liệu đối tượng có cần bật thông báo sắp tới hay không.

Phương thức

addmessage

 Thêm một thông báo vào đối tượng chung được tham chiếu theo mã đối tượng đã cho.

get

 Trả về đối tượng chung có mã đối tượng đã cho.

insert

 Chèn một đối tượng chung có mã nhận dạng và thuộc tính đã cho.

list

 Trả về danh sách tất cả các đối tượng chung cho một mã nhà phát hành nhất định.

patch

 Cập nhật đối tượng chung được tham chiếu theo mã đối tượng đã cho.

update

 Cập nhật đối tượng chung được tham chiếu theo mã đối tượng đã cho.