Ресурс REST: 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
  ],
  "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)
  }
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

Копия полей, унаследованных от родительского класса. Эти поля извлекаются в ходе операции GET.

seatInfo

object (EventSeat)

Информация о месте в билете.

reservationInfo

object (EventReservationInfo)

Сведения о бронировании. Эта информация указывается во всех билетах одного заказа.

ticketHolderName

string

Имя владельца билета, если таковое имеется. Пример: "Иван Петров" или "Анна Смирнова".

ticketNumber

string

Номер билета. Это может быть уникальный идентификатор, выделяющий билет среди всех в системе эмитента (например XYZ1234512345) или среди остальных билетов в заказе (например 1, 2 либо 3).

ticketType

object (LocalizedString)

Тип билета, например "Взрослый", "Детский", "VIP" или "Стандартный".

faceValue

object (Money)

Номинальная цена. Она должна совпадать с той, которая будет указана в печатной версии билета.

groupingInfo

object (GroupingInfo)

Сведения для группировки билетов на мероприятие

linkedOfferIds[]

string

Список объектов offer, привязанных к билету на мероприятие. Объекты offer должны уже существовать.

Идентификатор объекта offer должен иметь формат issuer ID.identifier (первая часть предоставляется Google, вторая задается вами).

id

string

Обязательно. Уникальный идентификатор объекта. Идентификаторы объектов у одного эмитента не могут повторяться. Значение указывается в следующем формате: issuer ID.identifier. При этом первая часть предоставляется Google, а вторая – выбирается вами. Идентификатор может содержать только буквы, цифры, точки, символы подчеркивания и дефисы.

classId

string

Обязательно. Класс, связанный с объектом. Элементы должны быть одного типа. Кроме того, класс должен быть существующим и одобренным.

Идентификатор класса должен иметь формат 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)

Список местоположений, где может использоваться объект. Эта информация необходима для показа уведомлений пользователям с учетом их местоположения. В случае конфликта данных этот список будет использоваться вместо адресов, содержащихся в классе, которые, в свою очередь, имеют приоритет над идентификаторами мест в Google.

hasUsers

boolean

Это поле показывает, есть ли у объекта пользователи. Заполняется автоматически.

smartTapRedemptionValue

string

Доступно только для партнеров, поддерживающих интеллектуальную бесконтактную технологию. За дополнительной информацией обращайтесь в службу поддержки.

hasLinkedDevice

boolean

Это поле показывает, связан ли объект с отдельным устройством. Заполняется автоматически, когда пользователь сохраняет объект и, тем самым, привязывает его к своему устройству. Доступно не для всех партнеров. За дополнительной информацией обращайтесь в службу поддержки.

disableExpirationNotification

boolean

Это поле показывает, должны ли блокироваться уведомления. Если установлено значение true, уведомления об истечении срока действия не будут приходить пользователю, даже если это противоречит настройке, заданной в поле messages. По умолчанию установлено значение false.

В настоящее время параметр можно задать только для специальных предложений.

infoModuleData

object (InfoModuleData)

Больше не используется. Вместо него используйте textModulesData.

imageModulesData[]

object (ImageModuleData)

Данные графического модуля. Отображается не более 1 поля из уровня объекта и 1 поля для уровня объекта класса.

textModulesData[]

object (TextModuleData)

Данные текстового модуля. Если для класса также задан текстовый модуль, то показываться будут оба. Отображается не более 10 полей из объекта и 10 полей из класса.

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)

Вход – с какой стороны должен войти зритель, чтобы пройти к своему месту, например "Левая сторона".

Локализуемое значение. Можно указывать слова или символы на другом языке.

EventReservationInfo

JSON-представление

{
  "kind": string,
  "confirmationCode": string
}
Поля
kind
(deprecated)

string

Определяет тип ресурса. Значение: фиксированная строка "walletobjects#eventReservationInfo".

confirmationCode

string

Код подтверждения для бронирования билета. Также может называться "номером заказа", "номером подтверждения", "номером бронирования" или другим эквивалентным понятием.

GroupingInfo

NEXT_ID: 2

JSON-представление

{
  "sortIndex": integer
}
Поля
sortIndex

integer

Дополнительный индекс для сортировки билетов, когда они группируются с другими. Билеты с более низким индексом сортировки отображаются перед билетами с более высоким индексом сортировки. Если индекс не указан, предполагается, что задано значение INT_MAX. Для двух билетов с одинаковым индексом сортировки порядок сортировки не определен.

Методы

addmessage

Добавляет сообщение к объекту event ticket, на который указывает идентификатор объекта.

get

Возвращает объект event ticket, на который ссылается указанный идентификатор.

insert

Добавляет объект event ticket с указанными идентификатором и свойствами.

list

Представляет список всех объектов event ticket, которые относятся к представленному идентификатору Issuer ID.

modifylinkedofferobjects

Изменяет объекты offer, связанные с объектом event ticket с указанным идентификатором.

patch

Изменяет объект event ticket, на который ссылается указанный идентификатор.

update

Изменяет объект event ticket с указанным идентификатором.