REST Resource: eventticketobject

Ressource: EventTicketObject

Représentation 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)
    }
  ]
}
Champs
kind
(deprecated)

string

Identifie le type de ressource. Valeur: chaîne fixe "walletobjects#eventTicketObject".

classReference

object (EventTicketClass)

Copie des champs hérités de la classe parente. Ces champs sont récupérés lors d'une requête GET.

seatInfo

object (EventSeat)

Informations sur les places assises pour ce billet.

reservationInfo

object (EventReservationInfo)

Détails de la réservation pour ce billet. Il devrait être partagé entre tous les billets achetés dans la même commande.

ticketHolderName

string

Nom du titulaire de la demande, si elle est attribuée à une personne. Exemple : "Jean Dupont" ou "Marie Dupont".

ticketNumber

string

Numéro du billet. Il peut s'agir d'un identifiant unique pour tous les billets du système d'un émetteur, pour tous les billets de l'événement (par exemple, XYZ1234512345) ou pour tous les billets de la commande (1, 2, 3, etc.).

ticketType

object (LocalizedString)

Type de billet (par exemple, "Adulte", "Enfant", "VIP" ou "Standard").

faceValue

object (Money)

Valeur faciale du billet, correspondant à ce qui serait imprimé sur une version physique du billet.

groupingInfo

object (GroupingInfo)

Information qui gère le regroupement des cartes.

linkedOfferIds[]

string

Liste des objets d'offre associés à ce billet d'événement. Les objets d'offre doivent déjà exister.

Les ID d'objet d'offre doivent respecter le format issuer ID.identifier, où le premier est émis par Google et le deuxième est choisi par vous.

hexBackgroundColor

string

Couleur d'arrière-plan de la fiche. Si cette option n'est pas définie, la couleur dominante de l'image héros est utilisée. Si aucune image héros n'est définie, la couleur dominante du logo est utilisée. Le format est #rrggbb, où rrggbb est un triplet RVB au format hexadécimal, tel que #ffcc00. Vous pouvez également utiliser la version abrégée du triplet RVB (# rgb, par exemple #fc0).

id

string

Obligatoire. Identifiant unique d'un objet. Cet identifiant doit être unique pour tous les objets d'un émetteur. Cette valeur doit respecter le format issuer ID.identifier, où le premier est émis par Google et le deuxième est choisi par vous. L'identifiant unique ne doit contenir que des caractères alphanumériques, des points, des traits d'union ou des tirets.

classId

string

Obligatoire. Classe associée à cet objet. La classe doit être du même type que cet objet, existe déjà et doit être approuvée.

Les ID de classe doivent respecter le format issuer ID.identifier, où le premier est émis par Google et le second est choisi par vous.

version
(deprecated)

string (int64 format)

Obsolète

state

enum (State)

Obligatoire. État de l'objet. Ce champ permet de déterminer la manière dont un objet s'affiche dans l'application. Par exemple, un objet inactive est déplacé dans la section "Cartes expirées".

barcode

object (Barcode)

Type et valeur du code-barres.

messages[]

object (Message)

Tableau des messages affichés dans l'application. Tous les utilisateurs de cet objet recevront les messages associés. Le nombre maximal de ces champs est de 10.

validTimeInterval

object (TimeInterval)

Période pendant laquelle cet objet sera active. L'objet peut être utilisé. L'état d'un objet passe à expired une fois ce délai écoulé.

locations[]
(deprecated)

object (LatLongPoint)

Remarque : Il n'est actuellement pas possible d'utiliser ce champ pour déclencher des notifications géo.

hasUsers

boolean

Indique si l'objet a des utilisateurs. Ce champ est défini par la plate-forme.

smartTapRedemptionValue

string

Valeur qui sera transmise à un terminal certifié Smart Tap via NFC pour cet objet. Les champs de niveau de classe enableSmartTap et redemptionIssuers doivent également être configurés correctement pour que la carte soit compatible avec Smart Tap. Seuls les caractères ASCII sont acceptés.

hasLinkedDevice

boolean

Indique si cet objet est actuellement associé à un seul appareil. Ce champ est défini par la plate-forme lorsqu'un utilisateur enregistre l'objet, en l'associant à son appareil. Destiné à certains partenaires. Pour en savoir plus, contactez l'assistance.

disableExpirationNotification

boolean

Indique si les notifications doivent être supprimées explicitement. Si ce champ est défini sur "True", les notifications d'expiration envoyées à l'utilisateur sont supprimées, quel que soit le champ messages. Par défaut, ce champ est défini sur "false".

Pour le moment, cette option ne peut être définie que pour les offres.

infoModuleData

object (InfoModuleData)

Obsolète. Utilisez plutôt textModulesData.

imageModulesData[]

object (ImageModuleData)

Données du module d'image. Le nombre maximal de ces champs affichés est 1 pour le niveau objet et 1 pour le niveau d'objet de classe.

textModulesData[]

object (TextModuleData)

Données du module de texte. Si des données de module de texte sont également définies sur le cours, les deux sont affichées. Le nombre maximal de ces champs affichés est de 10 pour l'objet et de 10 pour la classe.

rotatingBarcode

object (RotatingBarcode)

Type et valeur du code-barres rotatif.

heroImage

object (Image)

Image de bannière facultative affichée sur le recto de la fiche. Si aucune n'est présente, l'image héros de la classe, le cas échéant, sera affichée. Si l'image héros du cours n'est pas non plus présente, rien ne s'affiche.

passConstraints

object (PassConstraints)

Transmettez des contraintes pour l'objet. Inclut la limitation des comportements NFC et des captures d'écran.

saveRestrictions

object (SaveRestrictions)

Restrictions concernant l'objet qui doivent être validées avant que l'utilisateur ne tente d'enregistrer la carte. Notez que ces restrictions ne seront appliquées que pendant la sauvegarde. Si les restrictions changent après qu'un utilisateur a enregistré la carte, les nouvelles restrictions ne s'appliquent pas à une carte déjà enregistrée.

linkedObjectIds[]

string

L'élément linkedObjectIds est une liste d'autres objets (billet pour un événement, carte de fidélité, offre, générique, carte cadeau, carte de transport et carte d'embarquement, par exemple) qui doit être automatiquement associé à cet objet de billet pour un événement. Si un utilisateur a enregistré ce billet d'événement, ces linkedObjectIds sont automatiquement transférés vers son portefeuille (sauf s'il a désactivé le paramètre permettant de recevoir ces cartes associées).

Assurez-vous que les objets présents dans linkedObjectIds sont déjà insérés. Sinon, les appels échoueront. Une fois associés, les objets ne peuvent plus être dissociés. Vous ne pouvez pas associer d'objets appartenant à un autre émetteur. Le nombre d'objets pouvant être associés à un même objet est limité. Une fois la limite atteinte, les nouveaux objets associés de l'appel sont ignorés sans notification.

Les ID d'objet doivent respecter le format issuer ID.identifier, où le premier est émis par Google et le second est choisi par vous.

notifyPreference

enum (NotificationSettingsForUpdates)

Indique si les mises à jour de champ de cet objet doivent déclencher des notifications. Si la valeur est NOTIFY, nous tenterons de déclencher une notification de mise à jour de champ auprès des utilisateurs. Ces notifications ne sont envoyées aux utilisateurs que si le champ figure sur une liste d'autorisation. Si la valeur est DO_NOT_NOTIFY ou NOTIFICATION_SETTINGS_UNSPECIFIED, aucune notification ne sera déclenchée. Ce paramètre est éphémère et doit être défini avec chaque requête PATCH ou UPDATE, sinon aucune notification ne sera déclenchée.

valueAddedModuleData[]

object (ValueAddedModuleData)

Données du module avec valeur ajoutée facultative. Dix au maximum sur l'objet.

EventSeat

Représentation JSON
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
Champs
kind
(deprecated)

string

Identifie le type de ressource. Valeur : chaîne fixe "walletobjects#eventSeat".

seat

object (LocalizedString)

Numéro de siège, par exemple "1", "2", "3" ou tout autre identifiant de siège.

Ce champ peut être localisé. Vous pouvez donc traduire des mots ou utiliser des alphabets différents pour les caractères d'un identifiant.

row

object (LocalizedString)

Rangée du siège (par exemple, "1", "E", "BB" ou "A5").

Ce champ peut être localisé. Vous pouvez donc traduire des mots ou utiliser des alphabets différents pour les caractères d'un identifiant.

section

object (LocalizedString)

Section du siège, par exemple "121".

Ce champ est localisable. Vous pouvez donc traduire des mots ou utiliser différents alphabets pour les caractères d'un identifiant.

gate

object (LocalizedString)

La porte par laquelle le détenteur du billet doit passer pour accéder à son siège (par exemple, "A" ou "Ouest").

Ce champ est localisable. Vous pouvez donc traduire des mots ou utiliser différents alphabets pour les caractères d'un identifiant.

EventReservationInfo

Représentation JSON
{
  "kind": string,
  "confirmationCode": string
}
Champs
kind
(deprecated)

string

Identifie le type de ressource. Valeur : chaîne fixe "walletobjects#eventReservationInfo".

confirmationCode

string

Code de confirmation de la réservation de l'événement. Il peut également s'agir d'un "numéro de commande", d'un "numéro de confirmation", d'un "numéro de réservation" ou d'un autre équivalent.

Méthodes

addmessage

Ajoute un message à l'objet Billet pour un événement référencé par l'ID d'objet donné.

get

Renvoie l'objet "billet d'événement" associé à l'ID d'objet donné.

insert

Insère un objet Billet pour un événement avec l'ID et les propriétés indiqués.

list

Renvoie la liste de tous les objets de billets d'événement pour un ID d'émetteur donné.

modifylinkedofferobjects

Modifie les objets d'offre associés à l'objet Billet pour un événement avec l'ID donné.

patch

Met à jour l'objet Billet pour un événement référencé par l'ID d'objet donné.

update

Met à jour l'objet Billet pour un événement référencé par l'ID d'objet donné.