Tài nguyên: GenericObject
Đối tượng chung
Biểu diễn dưới dạng JSON |
---|
{ "genericType": enum ( |
Trường | |
---|---|
genericType |
Chỉ định thẻ này thuộc |
cardTitle |
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 thể dục", "Bảo hiểm AAA". Trường này là bắt buộc và xuất hiện trong hàng tiêu đề ở phía trên cùng của thẻ. |
subheader |
Nhãn tiêu đề của thẻ và vé, chẳng hạn như vị trí nơi thẻ/vé này có thể được sử dụng. Xuất hiện ngay phía trên tiêu đề trong hàng tiêu đề trong chế độ xem chi tiết của thẻ và vé. |
header |
Bắt buộc. Tiêu đề của thẻ và 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à xuất hiện trong hàng tiêu đề của chế độ xem thông tin chi tiết về thẻ và vé. |
logo |
Hình ảnh biểu trưng của thẻ và vé. Hình ảnh này hiển thị trong chế độ xem chi tiết thẻ ở phía trên bên trái, đồng thời hiển thị trong chế độ xem danh sách/hình thu nhỏ. Nếu không có biểu trưng, chữ cái đầu tiên của |
hexBackgroundColor |
Màu nền cho thẻ. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng màu chủ đạo của hình ảnh chính. 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 chủ đạo. |
notifications |
Chế độ cài đặt thông báo được bật cho đối tượng này. |
id |
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à duy nhất trên tất cả các đối tượng của công ty phát hành. Giá trị này phải tuân theo định dạng |
classId |
Bắt buộc. Lớp liên kết với đối tượng này. Lớp phải 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 |
barcode |
Loại và giá trị mã vạch. Nếu thẻ/vé không có mã vạch, chúng ta có thể cho phép bên phát hành đặt mã vạch Barcode.buyer_text và chỉ hiển thị mã đó. |
heroImage |
Ảnh biểu ngữ xuất hiện ở 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 |
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. Khi khoảng thời gian này 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[] |
Dữ liệu mô-đun hình ảnh. Chỉ một trong số các hình ảnh ở cấp lớp và một hình ảnh ở cấp đối tượng sẽ được kết xuất khi cả hai được đặt. |
textModulesData[] |
Dữ liệu mô-đun văn bản. Nếu |
linksModuleData |
Liên kết dữ liệu mô-đun. Nếu |
appLinkData |
Đường liên kết đến trang web hoặc ứng dụng (không bắt buộc) sẽ xuất hiện dưới dạng một nút ở mặt trước của thẻ và vé. Nếu AppLinkData được cung cấp cho đối tượng lớp tương ứng, thì chỉ có AppLinkData sẽ xuất hiện. |
groupingInfo |
Thông tin kiểm soát cách nhóm thẻ và vé lại với nhau. |
smartTapRedemptionValue |
Giá trị sẽ được truyền đến một thiết bị đầu cuối được chứng nhận bằng tính năng Chạm thông minh qua NFC đối với vật thể này. Bạn cũng phải thiết lập chính xác các trường cấp lớp |
rotatingBarcode |
Chế độ cài đặt/chi tiết mã vạch xoay. |
state |
Trạng thái của đối tượng. Trường này được 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 |
hasUsers |
Cho biết đối tượng có người dùng hay không. Trường này là do nền tảng thiết lập. |
passConstraints |
Truyền các quy tắc ràng buộc cho đối tượng. Bao gồm việc hạn chế hành vi NFC và ảnh chụp màn hình. |
wideLogo |
Biểu trưng rộng của thẻ/vé. Khi được cung cấp, tên này sẽ được sử dụng thay cho biểu trưng ở phía trên cùng bên trái của chế độ xem thẻ. |
saveRestrictions |
Các hạn chế đối với đối tượng cần được xác minh trước khi người dùng cố gắng lưu thẻ và vé. Xin lưu ý rằng các hạn chế này sẽ chỉ áp dụng trong thời gian tiết kiệm. Nếu các quy định hạn chế thay đổi sau khi người dùng lưu thẻ và vé, thì các hạn chế mới sẽ không áp dụng cho một thẻ và vé đã lưu. |
GenericType
Loại thẻ chung.
Enum | |
---|---|
GENERIC_TYPE_UNSPECIFIED |
Loại chung không được chỉ đị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 |
Đặt chỗ |
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 hai thông báo Hết hạn/Thông báo sắp tới. 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 ( |
Trường | |
---|---|
expiryNotification |
Hệ thống sẽ kích hoạt thông báo vào một thời điểm cụ thể trước khi thẻ hết hạn. |
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ề thời gian 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 |
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ẻ sắp tới 1 ngày trước khi thẻ có hiệu lực/có thể sử dụng.
Biểu diễn dưới dạng JSON |
---|
{ "enableNotification": boolean } |
Trường | |
---|---|
enableNotification |
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 |
|
---|---|
|
Thêm thông báo vào đối tượng chung được tham chiếu theo mã đối tượng đã cho. |
|
Trả về đối tượng chung có mã đối tượng đã cho. |
|
Chèn một đối tượng chung có mã nhận dạng và các thuộc tính đã cho. |
|
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. |
|
Cập nhật đối tượng chung được tham chiếu theo mã đối tượng đã cho. |
|
Cập nhật đối tượng chung được tham chiếu theo mã đối tượng đã cho. |