Tài nguyên: GiftCardObject
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "classReference": { object ( |
Trường | |
---|---|
kind |
Xác định loại tài nguyên này. Giá trị: chuỗi cố định |
classReference |
Bản sao các trường kế thừa của lớp mẹ. Các trường này được truy xuất trong quá trình GET. |
cardNumber |
Bắt buộc. Số của thẻ. |
pin |
Mã PIN của thẻ. |
balance |
Số dư bằng tiền trong thẻ. |
balanceUpdateTime |
Ngày và giờ cập nhật số dư gần đây nhất. Bắt buộc phải có mức chênh lệch. Nếu bạn cập nhật số dư mà không cung cấp thuộc tính này, thì hệ thống sẽ mặc định đặt thành thời gian hiện tại. |
eventNumber |
Mã sự kiện của thẻ, một trường không bắt buộc mà một số thẻ quà tặng sử dụng. |
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 issuer ID.identifier, trong đó mã bưu chính do Google phát hành còn mã sau do bạn chọn. Giá trị nhận dạng duy nhất chỉ được bao gồm ký tự chữ-số, ".", "_" hoặc "-". |
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 issuer ID.identifier, trong đó mã bưu chính do Google phát hành còn mã sau do bạn chọn. |
version |
Không được dùng nữa |
state |
Bắt buộc. 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 |
barcode |
Loại và giá trị mã vạch. |
messages[] |
Một mảng thông báo hiển thị trong ứng dụng. Tất cả người dùng của đối tượng này sẽ nhận được thông báo liên quan. Số lượng tối đa các trường này là 10. |
validTimeInterval |
Khoảng thời gian đối tượng này sẽ là |
locations[] |
Lưu ý: Trường này hiện không được hỗ trợ để kích hoạt thông báo theo vị trí địa lý. |
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. |
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 |
hasLinkedDevice |
Liệu đối tượng này hiện có liên kết với một thiết bị nào hay không. Trường này do nền tảng đặt khi người dùng lưu đối tượng, liên kết đối tượng đó với thiết bị của họ. Dành cho một số đối tác chọn lọc sử dụng. Hãy liên hệ với nhóm hỗ trợ để biết thêm thông tin. |
disableExpirationNotification |
Cho biết liệu có cần chặn thông báo một cách rõ ràng hay không. Nếu bạn đặt trường này thành true, thì thông báo hết hạn cho người dùng sẽ bị chặn, bất kể trường Hiện tại, bạn chỉ có thể đặt chế độ cài đặt này cho các mặt hàng. |
infoModuleData |
Không dùng nữa. Thay vào đó, hãy sử dụng textModulesData. |
imageModulesData[] |
Dữ liệu mô-đun hình ảnh. Số lượng trường tối đa được hiển thị là 1 trường ở cấp đối tượng và 1 trường ở cấp đối tượng lớp. |
textModulesData[] |
Dữ liệu mô-đun văn bản. Nếu dữ liệu mô-đun văn bản cũng được xác định trên lớp này, thì cả hai đều sẽ hiển thị. Số lượng tối đa các trường này được hiển thị là 10 trường từ đối tượng và 10 trường từ lớp. |
linksModuleData |
Liên kết dữ liệu mô-đun. Nếu dữ liệu mô-đun đường liên kết cũng được xác định trên lớp này, thì cả hai đều sẽ hiển thị. |
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. |
rotatingBarcode |
Giá trị và loại mã vạch xoay vòng. |
heroImage |
Ảnh biểu ngữ không bắt buộc xuất hiện ở mặt trước của thẻ. Nếu không có lớp nào, hình ảnh chính của lớp (nếu có) sẽ xuất hiện. Nếu cũng không có hình ảnh chính của lớp, thì sẽ không có nội dung nào hiển thị. |
groupingInfo |
Thông tin kiểm soát cách nhóm thẻ và vé lại với nhau. |
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. |
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. |
Phương thức |
|
---|---|
|
Thêm thông báo vào đối tượng thẻ quà tặng được tham chiếu theo mã đối tượng đã cho. |
|
Trả về đối tượng thẻ quà tặng có mã đối tượng đã cho. |
|
Chèn một đối tượng thẻ quà tặng có mã nhận dạng và thuộc tính đã cho. |
|
Trả về danh sách tất cả đối tượng thẻ quà tặng cho một mã nhà phát hành cụ thể. |
|
Cập nhật đối tượng thẻ quà tặng được tham chiếu theo mã đối tượng đã cho. |
|
Cập nhật đối tượng thẻ quà tặng được tham chiếu theo mã đối tượng đã cho. |