REST Resource: eventticketobject

리소스: EventTicketObject

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)
  }
}
필드
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

상위 클래스의 상속된 필드 사본입니다. 이러한 필드는 GET 실행 중에 검색됩니다.

seatInfo

object (EventSeat)

이 티켓의 좌석 세부정보입니다.

reservationInfo

object (EventReservationInfo)

이 티켓의 예약 세부정보입니다. 이 정보는 동일한 주문으로 구매한 모든 티켓에서 공유됩니다.

ticketHolderName

string

티켓이 개인에게 할당된 경우 티켓 소지자의 이름입니다. 예: 'John Doe' 또는 'Jane Doe'

ticketNumber

string

티켓 번호입니다. 발급기관 시스템의 모든 티켓, 이벤트의 모든 티켓 (예: XYZ1234512345) 또는 주문의 모든 티켓 (1, 2, 3 등)의 고유 식별자가 될 수 있습니다.

ticketType

object (LocalizedString)

티켓 유형입니다(예: '성인' 또는 '어린이', 'VIP' 또는 '일반').

faceValue

object (Money)

실제 티켓에 인쇄되는 것과 일치하는 티켓의 액면가입니다.

groupingInfo

object (GroupingInfo)

패스를 그룹화하는 방법을 제어하는 정보입니다.

linkedOfferIds[]

string

이 이벤트 티켓에 연결된 혜택 객체의 목록입니다. 쿠폰 객체가 이미 있어야 합니다.

쿠폰 객체 ID는 issuer ID 형식을 따라야 합니다.identifier의 경우 전자는 Google에서 발급하며 후자는 개발자가 선택합니다.

hexBackgroundColor

string

카드의 배경 색상입니다. 설정하지 않으면 히어로 이미지의 주요 색상이 사용되고, 설정된 히어로 이미지가 없으면 로고의 주요 색상이 사용됩니다. 형식은 #rrggbb입니다. 여기서 rrggbb는 #ffcc00과 같은 16진수 RGB 3색입니다. #fc0와 같은 RGB 3색의 축약 버전(#rgb)을 사용해도 됩니다.

id

string

필수 항목입니다. 객체의 고유 식별자입니다. 이 ID는 한 발급기관의 모든 객체에서 고유해야 합니다. 이 값은 issuer ID 형식을 따라야 합니다.identifier의 경우 전자는 Google에서 발급하며 후자는 개발자가 선택합니다. 고유 식별자에는 영숫자 문자, '.', '_', '-'만 포함되어야 합니다.

classId

string

필수 항목입니다. 이 객체와 연결된 클래스입니다. 클래스는 이 객체와 유형이 같아야 하고 이미 존재해야 하며 승인을 받아야 합니다.

클래스 ID는 issuer ID 형식을 따라야 합니다.identifier의 경우 전자는 Google에서 발급하며 후자는 개발자가 선택합니다.

version
(deprecated)

string (int64 format)

지원 중단됨

state

enum (State)

필수 항목입니다. 객체의 상태입니다. 이 필드는 객체가 앱에 표시되는 방식을 결정하는 데 사용됩니다. 예를 들어 inactive 객체는 '만료된 패스' 섹션으로 이동합니다.

barcode

object (Barcode)

바코드 유형 및 값입니다.

messages[]

object (Message)

앱에 표시되는 메시지의 배열입니다. 이 객체의 모든 사용자는 연결된 메시지를 받습니다. 이러한 필드의 최대 개수는 10개입니다.

validTimeInterval

object (TimeInterval)

이 객체가 active 상태가 되고 객체를 사용할 수 있는 기간입니다. 이 기간이 지나면 객체의 상태가 expired로 변경됩니다.

locations[]

object (LatLongPoint)

참고: 이 필드는 현재 지역 알림을 트리거하는 데 지원되지 않습니다.

hasUsers

boolean

객체에 사용자가 있는지 여부를 나타냅니다. 이 필드는 플랫폼에서 설정합니다.

smartTapRedemptionValue

string

이 객체의 NFC를 통해 스마트 탭 인증 단말기로 전송되는 값입니다. 패스가 스마트 탭을 지원하려면 클래스 수준 필드 enableSmartTapredemptionIssuers도 올바르게 설정해야 합니다. ASCII 문자만 지원됩니다.

hasLinkedDevice

boolean

이 객체가 현재 단일 기기에 연결되어 있는지 여부입니다. 이 필드는 사용자가 객체를 저장하여 기기에 연결할 때 플랫폼에서 설정합니다. 일부 파트너만 사용할 수 있습니다. 자세한 내용은 지원팀에 문의하세요.

disableExpirationNotification

boolean

알림을 명시적으로 해제해야 하는지 여부를 나타냅니다. 이 필드를 true로 설정하면 messages 필드에 관계없이 사용자에게 만료 알림이 표시되지 않습니다. 이 필드의 기본 설정값은 false입니다.

현재 이 속성은 혜택에만 설정할 수 있습니다.

infoModuleData

object (InfoModuleData)

지원이 중단되었습니다. 대신 textModulesData를 사용하세요.

imageModulesData[]

object (ImageModuleData)

이미지 모듈 데이터입니다. 이러한 필드의 최대 개수는 객체 수준에서 1개, 클래스 객체 수준에서는 1개입니다.

textModulesData[]

object (TextModuleData)

텍스트 모듈 데이터입니다. 텍스트 모듈 데이터가 클래스에도 정의되어 있으면 둘 다 표시됩니다. 이러한 필드의 최대 개수는 객체에서 10개, 클래스에서 10개입니다.

rotatingBarcode

object (RotatingBarcode)

회전하는 바코드 유형 및 값입니다.

heroImage

object (Image)

카드 앞면에 표시되는 배너 이미지(선택사항)입니다. 아무것도 없으면 클래스의 히어로 이미지(있는 경우)가 표시됩니다. 클래스의 히어로 이미지도 없으면 아무것도 표시되지 않습니다.

passConstraints

object (PassConstraints)

객체의 제약 조건을 전달합니다. NFC 및 스크린샷 동작 제한을 포함합니다.

EventSeat

JSON 표현
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
필드
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#eventSeat".

seat

object (LocalizedString)

'1', '2', '3'과 같은 좌석 번호 또는 기타 좌석 식별자입니다.

이 필드는 현지화가 가능하므로 단어를 번역하거나 식별자의 문자에 다른 영문자를 사용할 수 있습니다.

row

object (LocalizedString)

좌석의 열입니다(예: '1', 'E', 'BB', 'A5').

이 필드는 현지화가 가능하므로 단어를 번역하거나 식별자의 문자에 다른 영문자를 사용할 수 있습니다.

section

object (LocalizedString)

좌석의 섹션입니다(예: '121').

이 필드는 현지화가 가능하므로 단어를 번역하거나 식별자의 문자에 다른 영문자를 사용할 수 있습니다.

gate

object (LocalizedString)

티켓 소지자가 좌석으로 가기 위해 들어가야 하는 게이트입니다(예: 'A' 또는 'West').

이 필드는 현지화가 가능하므로 단어를 번역하거나 식별자의 문자에 다른 영문자를 사용할 수 있습니다.

EventReservationInfo

JSON 표현
{
  "kind": string,
  "confirmationCode": string
}
필드
kind
(deprecated)

string

리소스 종류를 식별합니다. 값: 고정 문자열 "walletobjects#eventReservationInfo".

confirmationCode

string

이벤트 예약의 확인 코드입니다. '주문 번호', '확인 번호', '예약 번호' 또는 이와 유사한 형식으로 표시될 수도 있습니다.

방법

addmessage

지정된 객체 ID로 참조되는 이벤트 티켓 객체에 메시지를 추가합니다.

get

지정된 객체 ID가 있는 이벤트 티켓 객체를 반환합니다.

insert

지정된 ID와 속성이 있는 이벤트 티켓 객체를 삽입합니다.

list

지정된 발급기관 ID의 모든 이벤트 티켓 객체 목록을 반환합니다.

modifylinkedofferobjects

지정된 ID가 있는 이벤트 티켓 객체의 연결된 쿠폰 객체를 수정합니다.

patch

지정된 객체 ID로 참조되는 이벤트 티켓 객체를 업데이트합니다.

update

지정된 객체 ID로 참조되는 이벤트 티켓 객체를 업데이트합니다.