REST Resource: eventticketobject

Tài nguyên: EventTicketObject

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên đây. Giá trị: chuỗi cố định "walletobjects#eventTicketObject".
classReference

object (EventTicketClass)

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.
seatInfo

object (EventSeat)

Thông tin về chỗ ngồi cho vé này.
reservationInfo

object (EventReservationInfo)

Thông tin đặt chỗ của vé này. Thông tin này dự kiến sẽ được chia sẻ giữa tất cả vé được mua trong cùng một đơn đặt hàng.
ticketHolderName

string

Tên của chủ vé, nếu vé được chỉ định cho một người. Ví dụ: "John Doe" hoặc "Jane Doe".
ticketNumber

string

Số vé. Đây có thể là giá trị nhận dạng duy nhất trên tất cả vé trong hệ thống của đơn vị phát hành, tất cả vé cho sự kiện (ví dụ: XYZ1234512345) hoặc tất cả vé trong đơn đặt hàng (1, 2, 3, v.v.).
ticketType

object (LocalizedString)

Loại vé, chẳng hạn như "Người lớn" hoặc "Trẻ em" hoặc "VIP" hoặc "Chuẩn".
faceValue

object (Money)

Giá trị mặt vé, khớp với giá trị được in trên phiên bản vé thực.
groupingInfo

object (GroupingInfo)

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

string

Danh sách đối tượng ưu đãi được liên kết với vé sự kiện này. Đối tượng ưu đãi phải tồn tại.

Mã đối tượng ưu đãi 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.
hexBackgroundColor

string

Màu nền cho thẻ. Nếu bạn không đặt, hệ thống sẽ sử dụng màu chủ đạo của hình ảnh chính và nếu bạn không đặt hình ảnh chính, hệ thống sẽ sử dụng màu chủ đạo của biểu trưng. Định dạng là #rrggbb, trong đó rrggbb là bộ ba RGB thập lục phân, chẳng hạn như #ffcc00. Bạn cũng có thể sử dụng phiên bản viết tắt của bộ ba RGB là #rgb, chẳng hạn như #fc0.
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à duy nhất trên tất cả các đối tượng của một tổ chức phát hành. Giá trị này phải tuân theo định dạng issuer ID.identifier, trong đó mã nhận dạng trước do Google phát hành và mã nhận dạng sau do bạn chọn. Giá trị nhận dạng duy nhất chỉ được chứa các ký tự chữ và số, dấu chấm ("."), dấu gạch dưới ("_") hoặc dấu gạch ngang ("-").
classId

string

Bắt buộc. Lớp liên kết với đối tượng này. Lớp này 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 tuân theo định dạng issuer ID.identifier, trong đó mã nhận dạng trước do Google phát hành và mã nhận dạng sau do bạn chọn.
version
(deprecated)

string (int64 format)

Không được dùng nữa
state

enum (State)

Bắt buộc. Trạng thái của đối tượng. Trường này dùng để xác định cách hiển thị một đối tượng trong ứng dụng. Ví dụ: đối tượng inactive được chuyển sang phần "Thẻ và vé đã hết hạn".
barcode

object (Barcode)

Loại và giá trị mã vạch.
messages[]

object (Message)

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

object (TimeInterval)

Khoảng thời gian đối tượng này sẽ là active và đối tượng có thể được sử dụng. Trạng thái của đối tượng sẽ được thay đổi thành expired khi khoảng thời gian này đã trôi qua.
locations[]
(deprecated)

object (LatLongPoint)

Lưu ý: Trường này hiện không được hỗ trợ để kích hoạt thông báo theo vị trí.
hasUsers

boolean

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

string

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 đúng cách các trường cấp lớp enableSmartTap và redemptionIssuers để thẻ và vé hỗ trợ tính năng Chạm thông minh. Chỉ hỗ trợ ký tự ASCII.
hasLinkedDevice

boolean

Liệu đối tượng này có đang được liên kết với một thiết bị 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. Hãy liên hệ với nhóm hỗ trợ để biết thêm thông tin.
disableExpirationNotification

boolean

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 messages là gì. Theo mặc định, trường này được đặt thành false.

Hiện tại, bạn chỉ có thể đặt giá trị này cho các mặt hàng.
infoModuleData

object (InfoModuleData)

Không dùng nữa. Thay vào đó, hãy sử dụng textModulesData.
imageModulesData[]

object (ImageModuleData)

Dữ liệu mô-đun hình ảnh. Số lượng tối đa của các trường này hiển thị là 1 từ cấp đối tượng và 1 cho cấp đối tượng lớp.
textModulesData[]

object (TextModuleData)

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ủa các trường này hiển thị là 10 từ đối tượng và 10 từ lớp.
rotatingBarcode

object (RotatingBarcode)

Loại và giá trị mã vạch xoay.
heroImage

object (Image)

Ả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ó hình ảnh 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ị.
passConstraints

object (PassConstraints)

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

object (SaveRestrictions)

Các quy định 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 quy định hạn chế này sẽ chỉ được áp dụng trong thời gian tiết kiệm pin. 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 quy định hạn chế mới sẽ không được áp dụng cho thẻ và vé đã lưu.
linkedObjectIds[]

string

linkedObjectIds là danh sách các đối tượng khác như vé xem sự kiện, chương trình khách hàng thân thiết, ưu đãi, thông tin chung, thẻ quà tặng, thẻ đi phương tiện công cộng và thẻ lên máy bay sẽ được tự động thêm vào đối tượng vé xem sự kiện này. Nếu người dùng đã lưu vé xem sự kiện này, thì các linkedObjectId này sẽ tự động được đẩy vào ví của người dùng (trừ phi họ tắt chế độ cài đặt để nhận các thẻ và vé được liên kết như vậy).

Đảm bảo rằng các đối tượng có trong linkedObjectIds đã được chèn – nếu không, các lệnh gọi sẽ không thành công. Sau khi liên kết, bạn không thể huỷ liên kết các đối tượng đã liên kết. Bạn không thể liên kết các đối tượng thuộc về một tổ chức phát hành khác. Có giới hạn về số lượng đối tượng có thể được liên kết với một đối tượng. Sau khi đạt đến giới hạn, các đối tượng liên kết mới trong cuộc gọi sẽ tự động bị bỏ qua.

Mã đối tượng phải tuân theo định dạng issuer ID.identifier, trong đó mã xác thực trước do Google phát hành và mã xác thực sau do bạn chọn.
notifyPreference

enum (NotificationSettingsForUpdates)

Liệu việc cập nhật trường cho đối tượng này có kích hoạt thông báo hay không. Khi được đặt thành NOTIFY, chúng tôi sẽ cố gắng kích hoạt thông báo cập nhật trường cho người dùng. Những thông báo này sẽ chỉ được gửi đến người dùng nếu trường đó nằm trong danh sách cho phép. Nếu bạn đặt thành DO_NOT_NOTIFY hoặc NOTIFICATION_SETTINGS_UNSPECIFIED, thì hệ thống sẽ không kích hoạt thông báo nào. Chế độ cài đặt này là tạm thời và cần được đặt với mỗi yêu cầu PATCH hoặc UPDATE, nếu không thông báo sẽ không được kích hoạt.
valueAddedModuleData[]

object (ValueAddedModuleData)

Dữ liệu mô-đun giá trị gia tăng không bắt buộc. Tối đa 10 đối tượng trên đối tượng.

EventSeat

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên này. Giá trị: chuỗi cố định "walletobjects#eventSeat".
seat

object (LocalizedString)

Số chỗ ngồi, chẳng hạn như "1", "2", "3" hoặc bất kỳ giá trị nhận dạng chỗ ngồi nào khác.

Trường này có thể được bản địa hoá để bạn có thể dịch từ hoặc sử dụng các bảng chữ cái khác nhau cho các ký tự trong một giá trị nhận dạng.
row

object (LocalizedString)

Hàng ghế, chẳng hạn như "1", E", "BB" hoặc "A5".

Trường này có thể bản địa hoá nên bạn có thể dịch các từ hoặc sử dụng nhiều bảng chữ cái cho các ký tự trong giá trị nhận dạng.
section

object (LocalizedString)

Phần ghế, chẳng hạn như "121".

Trường này có thể được bản địa hoá để bạn có thể dịch từ hoặc sử dụng các bảng chữ cái khác nhau cho các ký tự trong một giá trị nhận dạng.
gate

object (LocalizedString)

Cổng mà người giữ vé phải vào để đến chỗ ngồi của họ, chẳng hạn như "A" hoặc "Phía tây".

Trường này có thể được bản địa hoá để bạn có thể dịch từ hoặc sử dụng các bảng chữ cái khác nhau cho các ký tự trong một giá trị nhận dạng.

EventReservationInfo

Biểu diễn dưới dạng JSON 
{
  "kind": string,
  "confirmationCode": string
}
Trường
kind
(deprecated)

string

Xác định loại tài nguyên đây. Giá trị: chuỗi cố định "walletobjects#eventReservationInfo".
confirmationCode

string

Mã xác nhận của lượt đặt trước sự kiện. Số này cũng có thể ở dạng "mã đơn đặt hàng", "số xác nhận", "số đặt trước" hoặc các thông tin tương đương khác.

Phương thức

addmessage

 Thêm thông báo vào đối tượng vé sự kiện được tham chiếu bằng mã đối tượng đã cho.

get

 Trả về đối tượng vé sự kiện có mã nhận dạng đối tượng đã cho.

insert

 Chèn một đối tượng vé xem sự kiện có mã và thuộc tính đã cho.

list

 Trả về danh sách tất cả đối tượng vé sự kiện cho một mã nhận dạng người phát hành nhất định.

modifylinkedofferobjects

 Sửa đổi đối tượng ưu đãi được liên kết cho đối tượng vé xem sự kiện bằng mã nhận dạng đã cho.

patch

 Cập nhật đối tượng vé sự kiện được tham chiếu bằng mã đối tượng đã cho.

update

 Cập nhật đối tượng vé sự kiện được tham chiếu bằng mã đối tượng đã cho.