REST Resource: eventticketclass

Ресурс: EventTicketClass

JSON-представление
{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  }
}
Поля
kind
(deprecated)

string

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

eventName

object ( LocalizedString )

Необходимый. Название мероприятия, например «LA Dodgers at SF Giants».

eventId

string

Идентификатор события. Этот идентификатор должен быть уникальным для каждого события в аккаунте. Он используется для группировки билетов, если пользователь сохранил несколько билетов на одно и то же мероприятие. Оно может содержать не более 64 символов.

Если это предусмотрено, группировка будет стабильной. Будьте осторожны с непреднамеренными столкновениями, чтобы избежать группировки заявок, которые не следует группировать. Если вы используете только один класс для каждого события, вы можете просто установить для него classId (с частью идентификатора издателя или без нее).

Если не указано иное, платформа попытается использовать другие данные для группировки заявок (потенциально нестабильно).

venue

object ( EventVenue )

Подробности о месте проведения мероприятия.

dateTime

object ( EventDateTime )

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

confirmationCodeLabel

enum ( ConfirmationCodeLabel )

Метка, используемая для значения кода подтверждения ( eventTicketObject.reservationInfo.confirmationCode ) в представлении сведений о карте. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И confirmationCodeLabel , и customConfirmationCodeLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Код подтверждения». Если поле кода подтверждения не задано, эта метка не будет использоваться.

customConfirmationCodeLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения кода подтверждения ( eventTicketObject.reservationInfo.confirmationCode ) в представлении сведений о карте. Это следует использовать только в том случае, если метки «Код подтверждения» по умолчанию или одного из параметров confirmationCodeLabel недостаточно.

И confirmationCodeLabel , и customConfirmationCodeLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Код подтверждения». Если поле кода подтверждения не задано, эта метка не будет использоваться.

seatLabel

enum ( SeatLabel )

Метка, используемая для значения места ( eventTicketObject.seatInfo.seat ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба seatLabel и customSeatLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Место». Если поле места не установлено, эта метка не будет использоваться.

customSeatLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения места ( eventTicketObject.seatInfo.seat ) в подробном представлении карты. Это следует использовать только в том случае, если метки Seat по умолчанию или одного из параметров seatLabel недостаточно.

Оба seatLabel и customSeatLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Место». Если поле места не установлено, эта метка не будет использоваться.

rowLabel

enum ( RowLabel )

Метка, используемая для значения строки ( eventTicketObject.seatInfo.row ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И rowLabel , и customRowLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Строка». Если поле строки не установлено, эта метка не будет использоваться.

customRowLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения строки ( eventTicketObject.seatInfo.row ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Row» по умолчанию или одного из параметров rowLabel недостаточно.

И rowLabel , и customRowLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Строка». Если поле строки не установлено, эта метка не будет использоваться.

sectionLabel

enum ( SectionLabel )

Метка, используемая для значения раздела ( eventTicketObject.seatInfo.section ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба sectionLabel и customSectionLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Раздел». Если поле раздела не задано, эта метка не будет использоваться.

customSectionLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения раздела ( eventTicketObject.seatInfo.section ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Раздел» по умолчанию или одного из параметров sectionLabel недостаточно.

Оба sectionLabel и customSectionLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Раздел». Если поле раздела не задано, эта метка не будет использоваться.

gateLabel

enum ( GateLabel )

Метка, используемая для значения шлюза ( eventTicketObject.seatInfo.gate ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

И gateLabel , и customGateLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Ворота». Если поле ворота не установлено, эта метка не будет использоваться.

customGateLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения шлюза ( eventTicketObject.seatInfo.gate ) в подробном представлении карты. Это следует использовать только в том случае, если метки Gate по умолчанию или одного из параметров gateLabel недостаточно.

И gateLabel , и customGateLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Ворота». Если поле ворота не установлено, эта метка не будет использоваться.

finePrint

object ( LocalizedString )

Мелкий шрифт, условия билета.

classTemplateInfo

object ( ClassTemplateInfo )

Информация шаблона о том, как должен отображаться класс. Если этот параметр не установлен, Google вернется к набору полей по умолчанию для отображения.

id

string

Необходимый. Уникальный идентификатор класса. Этот идентификатор должен быть уникальным для всех классов издателя. Это значение должно соответствовать формату issuer ID . identifier , первый из которых выдается Google, а второй выбирается вами. Ваш уникальный идентификатор должен содержать только буквенно-цифровые символы, «.», «_» или «-».

version
(deprecated)

string ( int64 format)

Устарело

issuerName

string

Необходимый. Название эмитента. Рекомендуемая максимальная длина — 20 символов, чтобы обеспечить отображение всей строки на небольших экранах.

messages[]

object ( Message )

Массив сообщений, отображаемых в приложении. Все пользователи этого объекта получат связанные с ним сообщения. Максимальное количество этих полей — 10.

allowMultipleUsersPerObject
(deprecated)

boolean

Устарело. Вместо этого используйте multipleDevicesAndHoldersAllowedStatus .

homepageUri

object ( Uri )

URI домашней страницы вашего приложения. Заполнение URI в этом поле приводит к такому же поведению, что и заполнение URI в linkedModuleData (при визуализации объекта ссылка на домашнюю страницу отображается в том, что обычно считается разделом linkedModuleData объекта).

locations[]

object ( LatLongPoint )

Примечание. Это поле в настоящее время не поддерживается для запуска географических уведомлений.

reviewStatus

enum ( ReviewStatus )

Необходимый. Статус класса. В этом поле можно установить значение draft или underReview , используя вызовы API вставки, исправления или обновления. После изменения состояния проверки с draft его нельзя будет вернуть обратно в draft .

Это поле следует оставить для draft , пока класс находится в стадии разработки. draft класс нельзя использовать для создания какого-либо объекта.

Если вы считаете, что класс готов к использованию, вам следует установить в этом поле значение underReview . Платформа автоматически установит для этого поля approved , и его можно будет немедленно использовать для создания или переноса объектов.

При обновлении уже approved класса вам следует продолжать устанавливать в этом поле значение underReview .

review

object ( Review )

Комментарии к обзору, устанавливаемые платформой, когда класс помечается как approved или rejected .

infoModuleData
(deprecated)

object ( InfoModuleData )

Устарело. Вместо этого используйте textModulesData.

imageModulesData[]

object ( ImageModuleData )

Данные модуля изображения. Максимальное количество отображаемых полей — 1 на уровне объекта и 1 на уровне объекта класса.

textModulesData[]

object ( TextModuleData )

Текстовые данные модуля. Если в классе также определены данные текстового модуля, будут отображены оба. Максимальное количество отображаемых полей — 10 для объекта и 10 для класса.

redemptionIssuers[]

string ( int64 format)

Определяет, какие эмитенты погашения могут выкупить пропуск через Smart Tap. Эмитенты погашения идентифицируются по идентификатору эмитента. У эмитентов погашения должен быть настроен хотя бы один ключ Smart Tap.

Поля enableSmartTap и smartTapRedemptionLevel на уровне объекта также должны быть настроены правильно, чтобы пропуск поддерживал Smart Tap.

countryCode

string

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

heroImage

object ( Image )

Дополнительное изображение баннера, отображаемое на лицевой стороне карты. Если его нет, ничего не будет отображаться. Изображение будет отображаться с шириной 100%.

wordMark
(deprecated)

object ( Image )

Устарело.

enableSmartTap

boolean

Определяет, поддерживает ли этот класс Smart Tap. Поля redemptionIssuers и smartTapRedemptionLevel уровня объекта также должны быть настроены правильно, чтобы пропуск поддерживал Smart Tap.

hexBackgroundColor

string

Цвет фона карточки. Если этот параметр не установлен, используется доминирующий цвет главного изображения, а если главное изображение не установлено, используется доминирующий цвет логотипа. Формат: # rrggbb , где rrggbb — это шестнадцатеричный триплет RGB, например #ffcc00 . Вы также можете использовать сокращенную версию триплета RGB — rgb , например #fc0 .

localizedIssuerName

object ( LocalizedString )

Переведенные строки для имени эмитента. Рекомендуемая максимальная длина — 20 символов, чтобы обеспечить отображение всей строки на небольших экранах.

multipleDevicesAndHoldersAllowedStatus

enum ( MultipleDevicesAndHoldersAllowedStatus )

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

callbackOptions

object ( CallbackOptions )

Параметры обратного вызова, которые будут использоваться для обратного вызова эмитента при каждом сохранении/удалении объекта этого класса конечным пользователем. Все объекты этого класса имеют право на обратный вызов.

securityAnimation

object ( SecurityAnimation )

Дополнительная информация об анимации безопасности. Если этот параметр установлен, при деталях прохода будет отображаться анимация безопасности.

viewUnlockRequirement

enum ( ViewUnlockRequirement )

Просмотрите параметры требований к разблокировке для билета на мероприятие.

МероприятиеМесто проведения

JSON-представление
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Поля
kind
(deprecated)

string

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

name

object ( LocalizedString )

Название места проведения, например «AT&T Park».

Это необходимо.

address

object ( LocalizedString )

Адрес места проведения, например «24 Willie Mays Plaza\nSan Francisco, CA 94107». Строки адреса разделяются символами перевода строки ( \n ).

Это необходимо.

СобытиеДатаВремя

JSON-представление
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Поля
kind
(deprecated)

string

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

doorsOpen

string

Дата/время открытия дверей на площадке.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут 50,52 секунды после 19-го часа 12 апреля 1985 года без информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

start

string

Дата/время начала события. Если мероприятие длится несколько дней, это должна быть дата/время начала первого дня.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут 50,52 секунды после 19-го часа 12 апреля 1985 года без информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

end

string

Дата/время окончания события. Если событие длится несколько дней, это должна быть дата/время окончания последнего дня.

Это дата/время расширенного формата ISO 8601 со смещением или без него. Время может быть указано с точностью до наносекунды. Смещения могут быть указаны с точностью до секунды (хотя секунды смещения не являются частью ISO 8601).

Например:

1985-04-12T23:20:50.52Z будет через 20 минут 50,52 секунды после 23-го часа 12 апреля 1985 года по всемирному координированному времени.

1985-04-12T19:20:50.52-04:00 будет через 20 минут и 50,52 секунды после 19-го часа 12 апреля 1985 года, за 4 часа до UTC (тот же момент времени, что и в приведенном выше примере). Если бы мероприятие проходило в Нью-Йорке, это было бы эквивалентно восточному летнему времени (EDT). Помните, что смещение варьируется в регионах, где соблюдается летнее время (или летнее время), в зависимости от времени года.

1985-04-12T19:20:50.52 будет через 20 минут 50,52 секунды после 19-го часа 12 апреля 1985 года без информации о смещении.

Часть даты/времени без смещения считается «локальной датой/временем». Это должна быть местная дата/время места проведения. Например, если событие происходит в 20 часов 5 июня 2018 года в месте проведения, локальная часть даты/времени должна быть 2018-06-05T20:00:00 . Если местная дата/время в месте проведения на 4 часа раньше UTC, может быть добавлено смещение -04:00 .

Без информации о смещении некоторые богатые функции могут быть недоступны.

doorsOpenLabel

enum ( DoorsOpenLabel )

Метка, используемая для значения открытия дверей ( doorsOpen ) в подробном представлении карты. Каждый доступный параметр сопоставляется с набором локализованных строк, поэтому пользователю отображаются переводы в зависимости от его языкового стандарта.

Оба doorsOpenLabel и customDoorsOpenLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Двери открыты». Если поле «Двери открыты», эта метка не будет использоваться.

customDoorsOpenLabel

object ( LocalizedString )

Пользовательская метка, используемая для значения открытия дверей ( doorsOpen ) в подробном представлении карты. Это следует использовать только в том случае, если метки «Двери открыты» по умолчанию или одного из параметров doorsOpenLabel недостаточно.

Оба doorsOpenLabel и customDoorsOpenLabel не могут быть установлены. Если ни один из них не установлен, по умолчанию будет использоваться локализованная метка «Двери открыты». Если поле «Двери открыты», эта метка не будет использоваться.

ДвериОткрытыйЭтикетка

Перечисления
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

Устаревший псевдоним для DOORS_OPEN . Устарело.

GATES_OPEN
gatesOpen

Устаревший псевдоним для GATES_OPEN . Устарело.

КодПодтвержденияМетка

Перечисления
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

Устаревший псевдоним для CONFIRMATION_CODE . Устарело.

CONFIRMATION_NUMBER
confirmationNumber

Устаревший псевдоним для CONFIRMATION_NUMBER . Устарело.

ORDER_NUMBER
orderNumber

Устаревший псевдоним для ORDER_NUMBER . Устарело.

RESERVATION_NUMBER
reservationNumber

Устаревший псевдоним для RESERVATION_NUMBER . Устарело.

SeatLabel

Перечисления
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Устаревший псевдоним SEAT . Устарело.

Строкаметка

Перечисления
ROW_LABEL_UNSPECIFIED
ROW
row

Устаревший псевдоним для ROW . Устарело.

Метка раздела

Перечисления
SECTION_LABEL_UNSPECIFIED
SECTION
section

Устаревший псевдоним для SECTION . Устарело.

THEATER
theater

Устаревший псевдоним THEATER . Устарело.

Метка ворот

Перечисления
GATE_LABEL_UNSPECIFIED
GATE
gate

Устаревший псевдоним GATE . Устарело.

DOOR
door

Устаревший псевдоним DOOR . Устарело.

ENTRANCE
entrance

Устаревший псевдоним для ENTRANCE . Устарело.

Методы

addmessage

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

get

Возвращает класс билета события с заданным идентификатором класса.

insert

Вставляет класс билета события с заданным идентификатором и свойствами.

list

Возвращает список всех классов билетов событий для данного идентификатора издателя.

patch

Обновляет класс билета события, на который ссылается данный идентификатор класса.

update

Обновляет класс билета события, на который ссылается данный идентификатор класса.