Tài nguyên: EventVéClass
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "eventName": { object ( |
Trường | |
---|---|
kind |
Xác định loại tài nguyên này. Giá trị: chuỗi cố định |
eventName |
Bắt buộc. Tên của sự kiện, chẳng hạn như "LA Dodgers at SF Giants". |
eventId |
Mã của sự kiện. Mã này phải là mã riêng biệt cho mỗi sự kiện trong một tài khoản. Thuộc tính này được dùng để nhóm các vé lại với nhau nếu người dùng đã lưu nhiều vé cho cùng một sự kiện. Tên này có thể dài tối đa 64 ký tự. Nếu được cung cấp, nhóm này sẽ ổn định. Hãy cảnh giác với các xung đột ngoài ý muốn để tránh nhóm các phiếu yêu cầu hỗ trợ không nên nhóm lại. Nếu chỉ sử dụng một lớp cho mỗi sự kiện, bạn chỉ cần đặt thuộc tính này thành Nếu không được cung cấp, nền tảng sẽ tìm cách sử dụng dữ liệu khác để nhóm các phiếu yêu cầu hỗ trợ (có khả năng không ổn định). |
logo |
Hình ảnh biểu trưng của phiếu yêu cầu hỗ trợ. Hình ảnh này được hiển thị trong chế độ xem chi tiết thẻ của ứng dụng. |
venue |
Thông tin chi tiết về địa điểm tổ chức sự kiện. |
dateTime |
Thông tin về ngày và giờ của sự kiện. |
confirmationCodeLabel |
Nhãn để sử dụng cho giá trị mã xác nhận ( Bạn không thể đặt cả |
customConfirmationCodeLabel |
Một nhãn tuỳ chỉnh dùng cho giá trị mã xác nhận ( Bạn không thể đặt cả |
seatLabel |
Nhãn để sử dụng cho giá trị giấy phép ( Bạn không thể đặt cả |
customSeatLabel |
Một nhãn tuỳ chỉnh để sử dụng cho giá trị giấy phép ( Bạn không thể đặt cả |
rowLabel |
Nhãn để sử dụng cho giá trị hàng ( Bạn không thể đặt cả |
customRowLabel |
Một nhãn tuỳ chỉnh để sử dụng cho giá trị hàng ( Bạn không thể đặt cả |
sectionLabel |
Nhãn để sử dụng cho giá trị mục ( Bạn không thể đặt cả |
customSectionLabel |
Một nhãn tuỳ chỉnh để sử dụng cho giá trị mục ( Bạn không thể đặt cả |
gateLabel |
Nhãn để sử dụng cho giá trị cổng ( Bạn không thể đặt cả |
customGateLabel |
Một nhãn tuỳ chỉnh để sử dụng cho giá trị cổng ( Bạn không thể đặt cả |
finePrint |
Dòng chữ nhỏ, điều khoản hoặc điều kiện của phiếu yêu cầu hỗ trợ. |
classTemplateInfo |
Thông tin mẫu về cách hiển thị lớp. Nếu bạn không đặt trường này, Google sẽ dự phòng đến một nhóm trường mặc định để hiển thị. |
id |
Bắt buộc. Giá trị nhận dạng duy nhất của một lớp. Mã này của một nhà phát hành phải là duy nhất trên tất cả các lớp. Giá trị này phải tuân theo định dạng issuer ID.identifier, trong đó mã do Google phát hành và mã sau do bạn chọn. Giá trị nhận dạng duy nhất của bạn chỉ được bao gồm ký tự chữ-số, ".", "_" hoặc "-". |
version |
Không được dùng nữa |
issuerName |
Bắt buộc. Tên nhà phát hành. Bạn nên sử dụng độ dài tối đa là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên màn hình nhỏ hơn. |
messages[] |
Một dãy thông báo hiển thị trong ứng dụng. Tất cả người dùng đối tượng này sẽ nhận được các tin nhắn liên quan. Số lượng tối đa của các trường này là 10. |
allowMultipleUsersPerObject |
Không dùng nữa. Thay vào đó, hãy sử dụng |
homepageUri |
URI của trang chủ ứng dụng. Việc điền URI trong trường này sẽ dẫn đến hành vi giống hệt như việc điền URI trong linksModuleData (khi một đối tượng được kết xuất, một đường liên kết đến trang chủ sẽ xuất hiện trong phần linksModuleData của đối tượng). |
locations[] |
Lưu ý: Trường này hiện không được hỗ trợ để kích hoạt thông báo địa lý. |
reviewStatus |
Bắt buộc. Trạng thái của lớp. Bạn có thể đặt trường này thành Bạn nên lưu trường này thành Bạn nên đặt trường này thành Khi cập nhật một lớp |
review |
Các nhận xét về bài đánh giá do nền tảng đặt khi một lớp được đánh dấu là |
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 tối đa các trường này được hiển thị là 1 ở cấp đối tượng và 1 cho 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, thì cả hai sẽ hiển thị. Số lượng tối đa các trường này 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 liên kết cũng được xác định trên đối tượng, thì cả hai sẽ hiển thị. |
redemptionIssuers[] |
Xác định những tổ chức phát hành thẻ và vé có thể sử dụng tính năng Chạm thông minh. Nhà phát hành đổi thưởng được xác định theo mã nhà phát hành của họ. Nhà phát hành chương trình đổi thưởng phải thiết lập ít nhất một khoá Chạm thông minh. Bạn cũng phải thiết lập chính xác các trường |
countryCode |
Mã quốc gia dùng để hiển thị quốc gia của thẻ (khi người dùng không ở quốc gia đó), cũng như để hiển thị nội dung đã bản địa hoá khi nội dung không có sẵn bằng ngôn ngữ của người dù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ó giá trị nào hiển thị thì sẽ không có gì hiển thị. Hình ảnh sẽ hiển thị với chiều rộng 100%. |
wordMark |
Không dùng nữa. |
enableSmartTap |
Xác định xem lớp này có hỗ trợ công nghệ Chạm thông minh hay không. Bạn cũng phải thiết lập chính xác các trường |
hexBackgroundColor |
Màu nền cho thẻ. Nếu bạn không thiết lập màu chủ đạo của hình ảnh chính sẽ được sử dụng, còn nếu bạn không thiết lập hình ảnh chính, thì màu chủ đạo của biểu trưng sẽ được sử dụng. Định dạng là #rrggbb, trong đó rrggbb là bộ ba hệ thập lục phân RGB, chẳng hạn như |
localizedIssuerName |
Chuỗi văn bản được dịch cho tên nhà phát hành. Bạn nên sử dụng độ dài tối đa là 20 ký tự để đảm bảo chuỗi đầy đủ hiển thị trên màn hình nhỏ hơn. |
multipleDevicesAndHoldersAllowedStatus |
Xác định xem nhiều người dùng và thiết bị có lưu cùng một đối tượng tham chiếu đến lớp này hay không. |
callbackOptions |
Các tuỳ chọn gọi lại được dùng để gọi lại trình phát hành mỗi khi người dùng cuối lưu/xoá một đối tượng cho lớp này. Mọi đối tượng của lớp này đều đủ điều kiện để sử dụng lệnh gọi lại. |
securityAnimation |
Thông tin không bắt buộc về ảnh động bảo mật. Nếu bạn đặt chế độ này, một ảnh động bảo mật sẽ hiển thị khi bạn truyền thông tin chi tiết. |
viewUnlockRequirement |
Xem các tuỳ chọn Yêu cầu mở khoá cho vé xem sự kiện. |
wideLogo |
Biểu trưng rộng của vé. Khi được cung cấp, biểu tượng 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ẻ. |
appLinkData |
Đường liên kết không bắt buộc đến ứng dụng hoặc trang web sẽ xuất hiện dưới dạng một nút ở mặt trước của thẻ. Nếu bạn cung cấp AppLinkData cho đối tượng tương ứng sẽ được dùng. |
EventVenue
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "name": { object ( |
Trường | |
---|---|
kind |
Xác định loại tài nguyên này. Giá trị: chuỗi cố định |
name |
Tên của địa điểm, chẳng hạn như "AT&T Park". Đây là thông tin bắt buộc. |
address |
Địa chỉ của địa điểm, chẳng hạn như "24 Willie Mays Square\nSan Francisco, CA 94107". Các dòng địa chỉ được phân tách bằng ký tự trong nguồn cấp dữ liệu dòng ( Đây là thông tin bắt buộc. |
EventDateTime
Biểu diễn dưới dạng JSON |
---|
{ "kind": string, "doorsOpen": string, "start": string, "end": string, "doorsOpenLabel": enum ( |
Trường | |
---|---|
kind |
Xác định loại tài nguyên này. Giá trị: chuỗi cố định |
doorsOpen |
Ngày/giờ mở cửa tại địa điểm tổ chức sự kiện. Đây là ngày/giờ định dạng mở rộng ISO 8601, có hoặc không có độ lệch. Thời gian có thể được chỉ định với độ chính xác lên đến nano giây. Bạn có thể chỉ định mức chênh lệch với độ chính xác tính bằng giây (mặc dù số giây bù trừ không thuộc tiêu chuẩn ISO 8601). Ví dụ:
Phần ngày/giờ không có chênh lệch được coi là "ngày/giờ địa phương". Đây phải là ngày/giờ địa phương tại địa điểm tổ chức sự kiện. Ví dụ: nếu sự kiện xảy ra vào giờ thứ 20 của ngày 5 tháng 6 năm 2018 tại địa điểm tổ chức sự kiện, thì phần ngày/giờ địa phương sẽ là Nếu không có thông tin về mức chênh lệch, bạn có thể không dùng được một số tính năng đa dạng thức. |
start |
Ngày/giờ khi sự kiện bắt đầu. Nếu sự kiện kéo dài nhiều ngày, thì đó phải là ngày/giờ bắt đầu vào ngày đầu tiên. Đây là ngày/giờ định dạng mở rộng ISO 8601, có hoặc không có độ lệch. Thời gian có thể được chỉ định với độ chính xác lên đến nano giây. Bạn có thể chỉ định mức chênh lệch với độ chính xác tính bằng giây (mặc dù số giây bù trừ không thuộc tiêu chuẩn ISO 8601). Ví dụ:
Phần ngày/giờ không có chênh lệch được coi là "ngày/giờ địa phương". Đây phải là ngày/giờ địa phương tại địa điểm tổ chức sự kiện. Ví dụ: nếu sự kiện xảy ra vào giờ thứ 20 của ngày 5 tháng 6 năm 2018 tại địa điểm tổ chức sự kiện, thì phần ngày/giờ địa phương sẽ là Nếu không có thông tin về mức chênh lệch, bạn có thể không dùng được một số tính năng đa dạng thức. |
end |
Ngày/giờ khi sự kiện kết thúc. Nếu sự kiện kéo dài nhiều ngày, thì đó phải là ngày/giờ kết thúc vào ngày cuối cùng. Đây là ngày/giờ định dạng mở rộng ISO 8601, có hoặc không có độ lệch. Thời gian có thể được chỉ định với độ chính xác lên đến nano giây. Bạn có thể chỉ định mức chênh lệch với độ chính xác tính bằng giây (mặc dù số giây bù trừ không thuộc tiêu chuẩn ISO 8601). Ví dụ:
Phần ngày/giờ không có chênh lệch được coi là "ngày/giờ địa phương". Đây phải là ngày/giờ địa phương tại địa điểm tổ chức sự kiện. Ví dụ: nếu sự kiện xảy ra vào giờ thứ 20 của ngày 5 tháng 6 năm 2018 tại địa điểm tổ chức sự kiện, thì phần ngày/giờ địa phương sẽ là Nếu không có thông tin về mức chênh lệch, bạn có thể không dùng được một số tính năng đa dạng thức. |
doorsOpenLabel |
Nhãn sử dụng cho giá trị mở cửa ( Bạn không thể đặt cả |
customDoorsOpenLabel |
Một nhãn tuỳ chỉnh dùng cho giá trị của số lượt mở cửa ( Bạn không thể đặt cả |
DoorsOpenLabel
Enum | |
---|---|
DOORS_OPEN_LABEL_UNSPECIFIED |
|
DOORS_OPEN |
|
doorsOpen |
Bí danh cũ của |
GATES_OPEN |
|
gatesOpen |
Bí danh cũ của |
ConfirmationCodeLabel
Enum | |
---|---|
CONFIRMATION_CODE_LABEL_UNSPECIFIED |
|
CONFIRMATION_CODE |
|
confirmationCode |
Bí danh cũ của |
CONFIRMATION_NUMBER |
|
confirmationNumber |
Bí danh cũ của |
ORDER_NUMBER |
|
orderNumber |
Bí danh cũ của |
RESERVATION_NUMBER |
|
reservationNumber |
Bí danh cũ của |
SeatLabel
Enum | |
---|---|
SEAT_LABEL_UNSPECIFIED |
|
SEAT |
|
seat |
Bí danh cũ của |
RowLabel
Enum | |
---|---|
ROW_LABEL_UNSPECIFIED |
|
ROW |
|
row |
Bí danh cũ của |
SectionLabel
Enum | |
---|---|
SECTION_LABEL_UNSPECIFIED |
|
SECTION |
|
section |
Bí danh cũ của |
THEATER |
|
theater |
Bí danh cũ của |
GateLabel
Enum | |
---|---|
GATE_LABEL_UNSPECIFIED |
|
GATE |
|
gate |
Bí danh cũ của |
DOOR |
|
door |
Bí danh cũ của |
ENTRANCE |
|
entrance |
Bí danh cũ của |
Phương thức |
|
---|---|
|
Thêm một thông báo vào lớp vé xem sự kiện được tham chiếu theo mã lớp đã cho. |
|
Trả về hạng vé xem sự kiện có mã hạng cho trước. |
|
Chèn một hạng vé sự kiện có mã nhận dạng và thuộc tính đã cho. |
|
Trả về danh sách tất cả các hạng vé sự kiện cho một mã nhà phát hành nhất định. |
|
Cập nhật lớp vé xem sự kiện được tham chiếu theo mã lớp nhất định. |
|
Cập nhật lớp vé xem sự kiện được tham chiếu theo mã lớp nhất định. |