REST Resource: eventticketclass

Ressource: EventTicketClass

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

string

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

eventName

object (LocalizedString)

Obligatoire. Nom de l'événement, par exemple "LA Dodgers at SF Giants".

eventId

string

ID de l'événement. Il doit être unique pour chaque événement d'un compte. Il permet de regrouper les billets si l'utilisateur en a enregistré plusieurs pour le même événement. Il ne doit pas dépasser 64 caractères.

S'il est fourni, le regroupement sera stable. Méfiez-vous des collisions involontaires pour éviter de regrouper des billets qui ne devraient pas l'être. Si vous n'utilisez qu'une seule classe par événement, vous pouvez simplement définir cette valeur sur classId (avec ou sans la partie ID de l'émetteur).

Si aucune valeur n'est fournie, la plate-forme tente d'utiliser d'autres données pour regrouper les demandes d'assistance (potentiellement instable).

venue

object (EventVenue)

Détails sur le lieu de l'événement

dateTime

object (EventDateTime)

Informations sur la date et l'heure de l'événement.

confirmationCodeLabel

enum (ConfirmationCodeLabel)

Libellé à utiliser pour la valeur du code de confirmation (eventTicketObject.reservationInfo.confirmationCode) dans la vue détaillée de la carte. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

confirmationCodeLabel et customConfirmationCodeLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Code de confirmation", localisé. Si le champ du code de confirmation n'est pas défini, ce libellé ne sera pas utilisé.

customConfirmationCodeLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur du code de confirmation (eventTicketObject.reservationInfo.confirmationCode) dans la vue détaillée de la carte. N'utilisez cette option que si le libellé "Code de confirmation" par défaut ou l'une des options confirmationCodeLabel n'est pas suffisant.

confirmationCodeLabel et customConfirmationCodeLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Code de confirmation", localisé. Si le champ du code de confirmation n'est pas défini, ce libellé ne sera pas utilisé.

seatLabel

enum (SeatLabel)

Libellé à utiliser pour la valeur du siège (eventTicketObject.seatInfo.seat) dans la vue détaillée de la carte. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

seatLabel et customSeatLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Siège", localisé. Si le champ "Siège" n'est pas défini, ce libellé ne sera pas utilisé.

customSeatLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur du siège (eventTicketObject.seatInfo.seat) dans la vue détaillée de la carte. N'utilisez cette option que si le libellé "Siège" par défaut ou l'une des options seatLabel n'est pas suffisant.

seatLabel et customSeatLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Siège", localisé. Si le champ "Siège" n'est pas défini, ce libellé ne sera pas utilisé.

rowLabel

enum (RowLabel)

Libellé à utiliser pour la valeur de la ligne (eventTicketObject.seatInfo.row) dans la vue détaillée de la fiche. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

rowLabel et customRowLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Ligne", localisé. Si le champ de ligne n'est pas défini, ce libellé ne sera pas utilisé.

customRowLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur de la ligne (eventTicketObject.seatInfo.row) dans la vue détaillée de la fiche. N'utilisez ce paramètre que si le libellé "Ligne" par défaut ou l'une des options rowLabel n'est pas suffisant.

rowLabel et customRowLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Ligne", localisé. Si le champ de ligne n'est pas défini, ce libellé ne sera pas utilisé.

sectionLabel

enum (SectionLabel)

Libellé à utiliser pour la valeur de la section (eventTicketObject.seatInfo.section) dans la vue détaillée de la fiche. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

sectionLabel et customSectionLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Section", localisé. Si le champ de la section n'est pas défini, ce libellé ne sera pas utilisé.

customSectionLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur de la section (eventTicketObject.seatInfo.section) dans la vue détaillée de la fiche. N'utilisez ce paramètre que si le libellé par défaut "Section" ou l'une des options sectionLabel n'est pas suffisant.

sectionLabel et customSectionLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Section", localisé. Si le champ de la section n'est pas défini, ce libellé ne sera pas utilisé.

gateLabel

enum (GateLabel)

Étiquette à utiliser pour la valeur de la porte (eventTicketObject.seatInfo.gate) dans la vue détaillée de la carte. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

gateLabel et customGateLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Porte", localisé. Si le champ de la porte n'est pas défini, cette étiquette ne sera pas utilisée.

customGateLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur de la porte (eventTicketObject.seatInfo.gate) dans la vue détaillée de la carte. N'utilisez ce paramètre que si le libellé "Porte" par défaut ou l'une des options gateLabel n'est pas suffisant.

gateLabel et customGateLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Porte", localisé. Si le champ de la porte n'est pas défini, cette étiquette ne sera pas utilisée.

finePrint

object (LocalizedString)

Les conditions d'utilisation ou les conditions d'utilisation du billet.

classTemplateInfo

object (ClassTemplateInfo)

Informations du modèle sur la manière dont la classe doit s'afficher. Si cette règle n'est pas configurée, Google utilise alors un ensemble de champs par défaut à afficher.

id

string

Obligatoire. Identifiant unique d'une classe. Cet ID doit être unique parmi toutes les classes d'un émetteur. Cette valeur doit respecter le format issuer ID.identifier, lorsque le premier est émis par Google et le second est choisi par vous. Votre identifiant unique ne doit contenir que des caractères alphanumériques, ainsi que les caractères ".", "_" ou "-".

version
(deprecated)

string (int64 format)

Obsolète

issuerName

string

Obligatoire. Nom de l'émetteur. La longueur maximale recommandée est de 20 caractères, afin de garantir que la chaîne s'affiche entièrement sur des écrans de petite taille.

messages[]

object (Message)

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

allowMultipleUsersPerObject
(deprecated)

boolean

Obsolète. Utilisez multipleDevicesAndHoldersAllowedStatus à la place.

homepageUri

object (Uri)

URI de la page d'accueil de votre application. Le fait de renseigner l'URI dans ce champ produit exactement le même comportement que le remplissage d'un URI dans linksModuleData (lorsqu'un objet est affiché, un lien vers la page d'accueil s'affiche dans ce qui serait généralement considéré comme la section linksModuleData de l'objet).

locations[]

object (LatLongPoint)

Remarque: Pour le moment, ce champ ne permet pas de déclencher des notifications géographiques.

reviewStatus

enum (ReviewStatus)

Obligatoire. État du cours. Ce champ peut être défini sur draft ou underReview à l'aide des appels d'API d'insertion, de correctif ou de mise à jour. Une fois que l'état de l'examen est passé de "draft", il ne peut plus être redéfini sur "draft".

Vous devez conserver la valeur draft pour ce champ lorsque la classe est en cours de développement. Une classe draft ne peut pas être utilisée pour créer un objet.

Vous devez définir ce champ sur underReview lorsque vous pensez que la classe est prête à l'emploi. La plate-forme définit automatiquement ce champ sur approved. Il peut être immédiatement utilisé pour créer ou migrer des objets.

Lorsque vous mettez à jour une classe déjà approved, continuez à définir ce champ sur underReview.

review

object (Review)

Commentaires définis par la plate-forme lorsqu'une classe est marquée comme approved ou rejected.

infoModuleData
(deprecated)

object (InfoModuleData)

Obsolète. Utilisez plutôt textModulesData.

imageModulesData[]

object (ImageModuleData)

Données de module d'image. Le nombre maximal de champs affichés pour l'objet de classe est limité à un pour le niveau de l'objet et un au niveau de l'objet de classe.

textModulesData[]

object (TextModuleData)

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

redemptionIssuers[]

string (int64 format)

Identifie les émetteurs d'offres qui peuvent utiliser la carte via Smart Tap. Les émetteurs d'offres sont identifiés par leur ID. Les émetteurs d'offres doivent avoir configuré au moins une clé Smart Tap.

Les champs enableSmartTap et smartTapRedemptionLevel au niveau de l'objet doivent également être correctement configurés pour qu'une carte soit compatible avec Smart Tap.

countryCode

string

Code pays utilisé pour afficher le pays de la carte (lorsque l'utilisateur ne se trouve pas dans ce pays), ainsi que pour afficher le contenu localisé lorsqu'il n'est pas disponible dans les paramètres régionaux de l'utilisateur.

heroImage

object (Image)

Image de bannière facultative affichée au recto de la fiche. Si aucun n'est présent, rien ne s'affichera. L'image s'affiche à 100% de la largeur.

wordMark
(deprecated)

object (Image)

Obsolète.

enableSmartTap

boolean

Indique si cette classe est compatible avec Smart Tap. Les champs redemptionIssuers et smartTapRedemptionLevel au niveau de l'objet doivent également être correctement configurés pour qu'une carte soit compatible avec Smart Tap.

hexBackgroundColor

string

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

localizedIssuerName

object (LocalizedString)

Chaînes traduites pour l'émetteurName. La longueur maximale recommandée est de 20 caractères, afin de garantir que la chaîne s'affiche entièrement sur des écrans de petite taille.

multipleDevicesAndHoldersAllowedStatus

enum (MultipleDevicesAndHoldersAllowedStatus)

Indique si plusieurs utilisateurs et appareils vont enregistrer le même objet en référence à cette classe.

callbackOptions

object (CallbackOptions)

Options de rappel à utiliser pour rappeler l'émetteur à chaque enregistrement/suppression d'un objet de cette classe par l'utilisateur final. Tous les objets de cette classe sont éligibles pour le rappel.

securityAnimation

object (SecurityAnimation)

Informations facultatives sur l'animation de sécurité. Si cette option est définie, une animation de sécurité s'affiche sur les détails de la carte.

viewUnlockRequirement

enum (ViewUnlockRequirement)

Affichez les options de déverrouillage requises pour le billet pour un événement.

EventVenue

Représentation JSON
{
  "kind": string,
  "name": {
    object (LocalizedString)
  },
  "address": {
    object (LocalizedString)
  }
}
Champs
kind
(deprecated)

string

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

name

object (LocalizedString)

Nom du lieu, par exemple "AT&T Park".

Ce champ est obligatoire.

address

object (LocalizedString)

Adresse du lieu, par exemple "24 Willie Mays Plaza\nSan Francisco, CA 94107". Les lignes d'adresse sont séparées par des caractères de saut de ligne (\n).

Ce champ est obligatoire.

EventDateTime

Représentation JSON
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
Champs
kind
(deprecated)

string

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

doorsOpen

string

Date et heure d'ouverture des portes du lieu.

Il s'agit d'une date/heure exprimée dans le format étendu de la norme ISO 8601, avec ou sans décalage. L'heure peut être indiquée à la nanoseconde près. Les décalages peuvent être indiqués à la seconde près (même si le décalage des secondes n'est pas prévu par la norme ISO 8601).

Exemple :

1985-04-12T23:20:50.52Z correspond à 20 minutes et 50,52 secondes après la 23e heure, le 12 avril 1985, selon le fuseau UTC.

1985-04-12T19:20:50.52-04:00 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, 4 heures avant l'UTC (le même instant dans le temps que l'exemple ci-dessus). Si l'événement se trouvait à New York, il s'agirait de l'équivalent de l'heure avancée de l'Est (EDT). N'oubliez pas que le décalage varie en fonction de la période de l'année dans les régions qui appliquent le passage à l'heure d'été.

1985-04-12T19:20:50.52 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, sans information de décalage.

La partie de la date/heure sans le décalage est considérée comme la "date/heure locale". Il s'agit de la date et de l'heure locales du lieu. Par exemple, si l'événement a lieu à la 20e heure le 5 juin 2018 sur le lieu de l'événement, la partie date/heure locale doit être 2018-06-05T20:00:00. Si la date et l'heure locales du lieu sont quatre heures avant l'UTC, un décalage de -04:00 peut être ajouté.

Sans informations de décalage, certaines fonctionnalités enrichies risquent de ne pas être disponibles.

start

string

Date et heure de début de l'événement. Si l'événement s'étend sur plusieurs jours, il doit s'agir de la date et de l'heure de début du premier jour.

Il s'agit d'une date/heure exprimée dans le format étendu de la norme ISO 8601, avec ou sans décalage. L'heure peut être indiquée à la nanoseconde près. Les décalages peuvent être indiqués à la seconde près (même si le décalage des secondes n'est pas prévu par la norme ISO 8601).

Exemple :

1985-04-12T23:20:50.52Z correspond à 20 minutes et 50,52 secondes après la 23e heure, le 12 avril 1985, selon le fuseau UTC.

1985-04-12T19:20:50.52-04:00 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, 4 heures avant l'UTC (le même instant dans le temps que l'exemple ci-dessus). Si l'événement se trouvait à New York, il s'agirait de l'équivalent de l'heure avancée de l'Est (EDT). N'oubliez pas que le décalage varie en fonction de la période de l'année dans les régions qui appliquent le passage à l'heure d'été.

1985-04-12T19:20:50.52 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, sans information de décalage.

La partie de la date/heure sans le décalage est considérée comme la "date/heure locale". Il s'agit de la date et de l'heure locales du lieu. Par exemple, si l'événement a lieu à la 20e heure le 5 juin 2018 sur le lieu de l'événement, la partie date/heure locale doit être 2018-06-05T20:00:00. Si la date et l'heure locales du lieu sont quatre heures avant l'UTC, un décalage de -04:00 peut être ajouté.

Sans informations de décalage, certaines fonctionnalités enrichies risquent de ne pas être disponibles.

end

string

Date et heure de fin de l'événement. Si l'événement s'étend sur plusieurs jours, la date et l'heure de fin doivent correspondre au dernier jour.

Il s'agit d'une date/heure exprimée dans le format étendu de la norme ISO 8601, avec ou sans décalage. L'heure peut être indiquée à la nanoseconde près. Les décalages peuvent être indiqués à la seconde près (même si le décalage des secondes n'est pas prévu par la norme ISO 8601).

Exemple :

1985-04-12T23:20:50.52Z correspond à 20 minutes et 50,52 secondes après la 23e heure, le 12 avril 1985, selon le fuseau UTC.

1985-04-12T19:20:50.52-04:00 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, 4 heures avant l'UTC (le même instant dans le temps que l'exemple ci-dessus). Si l'événement se trouvait à New York, il s'agirait de l'équivalent de l'heure avancée de l'Est (EDT). N'oubliez pas que le décalage varie en fonction de la période de l'année dans les régions qui appliquent le passage à l'heure d'été.

1985-04-12T19:20:50.52 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, sans information de décalage.

La partie de la date/heure sans le décalage est considérée comme la "date/heure locale". Il s'agit de la date et de l'heure locales du lieu. Par exemple, si l'événement a lieu à la 20e heure le 5 juin 2018 sur le lieu de l'événement, la partie date/heure locale doit être 2018-06-05T20:00:00. Si la date et l'heure locales du lieu sont quatre heures avant l'UTC, un décalage de -04:00 peut être ajouté.

Sans informations de décalage, certaines fonctionnalités enrichies risquent de ne pas être disponibles.

doorsOpenLabel

enum (DoorsOpenLabel)

Étiquette à utiliser pour la valeur portes ouvertes (doorsOpen) dans la vue détaillée de la carte. Chaque option disponible est associée à un ensemble de chaînes localisées afin que les traductions soient proposées à l'utilisateur en fonction de ses paramètres régionaux.

doorsOpenLabel et customDoorsOpenLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Portes ouvertes", localisé. Si le champ "Portes ouvertes" n'est pas défini, ce libellé n'est pas utilisé.

customDoorsOpenLabel

object (LocalizedString)

Étiquette personnalisée à utiliser pour la valeur des portes ouvertes (doorsOpen) dans la vue détaillée de la carte. N'utilisez ce paramètre que si le libellé par défaut "Portes ouvertes" ou l'une des options doorsOpenLabel ne suffit pas.

doorsOpenLabel et customDoorsOpenLabel ne peuvent pas être définis. Si aucune de ces valeurs n'est définie, le libellé est défini par défaut sur "Portes ouvertes", localisé. Si le champ "Portes ouvertes" n'est pas défini, ce libellé n'est pas utilisé.

DoorsOpenLabel

Enums
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

Ancien alias de DOORS_OPEN. Obsolète.

GATES_OPEN
gatesOpen

Ancien alias de GATES_OPEN. Obsolète.

ConfirmationCodeLabel

Enums
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

Ancien alias de CONFIRMATION_CODE. Obsolète.

CONFIRMATION_NUMBER
confirmationNumber

Ancien alias de CONFIRMATION_NUMBER. Obsolète.

ORDER_NUMBER
orderNumber

Ancien alias de ORDER_NUMBER. Obsolète.

RESERVATION_NUMBER
reservationNumber

Ancien alias de RESERVATION_NUMBER. Obsolète.

SeatLabel

Enums
SEAT_LABEL_UNSPECIFIED
SEAT
seat

Ancien alias de SEAT. Obsolète.

RowLabel

Enums
ROW_LABEL_UNSPECIFIED
ROW
row

Ancien alias de ROW. Obsolète.

SectionLabel

Enums
SECTION_LABEL_UNSPECIFIED
SECTION
section

Ancien alias de SECTION. Obsolète.

THEATER
theater

Ancien alias de THEATER. Obsolète.

GateLabel

Enums
GATE_LABEL_UNSPECIFIED
GATE
gate

Ancien alias de GATE. Obsolète.

DOOR
door

Ancien alias de DOOR. Obsolète.

ENTRANCE
entrance

Ancien alias de ENTRANCE. Obsolète.

Méthodes

addmessage

Ajoute un message à la classe de billets pour un événement référencée par l'ID de classe donné.

get

Renvoie la classe de billet pour un événement avec l'ID de classe donné.

insert

Insère une classe de billets pour un événement avec l'ID et les propriétés indiqués.

list

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

patch

Met à jour la classe de billets pour un événement référencée par l'ID de classe donné.

update

Met à jour la classe de billets pour un événement référencée par l'ID de classe donné.