REST Resource: transitobject

Ressource: TransitObject

Représentation JSON
{
  "classReference": {
    object (TransitClass)
  },
  "ticketNumber": string,
  "passengerType": enum (PassengerType),
  "passengerNames": string,
  "tripId": string,
  "ticketStatus": enum (TicketStatus),
  "customTicketStatus": {
    object (LocalizedString)
  },
  "concessionCategory": enum (ConcessionCategory),
  "customConcessionCategory": {
    object (LocalizedString)
  },
  "ticketRestrictions": {
    object (TicketRestrictions)
  },
  "purchaseDetails": {
    object (PurchaseDetails)
  },
  "ticketLeg": {
    object (TicketLeg)
  },
  "ticketLegs": [
    {
      object (TicketLeg)
    }
  ],
  "hexBackgroundColor": string,
  "tripType": enum (TripType),
  "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)
  },
  "activationStatus": {
    object (ActivationStatus)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "deviceContext": {
    object (DeviceContext)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
Champs
classReference

object (TransitClass)

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

ticketNumber

string

Numéro du billet. Il s'agit de l'identifiant unique du titre de transport dans le système de l'opérateur de transports en commun.

passengerType

enum (PassengerType)

le nombre de passagers ;

passengerNames

string

Nom(s) des passagers auxquels le billet est attribué. Le champ passengerType ci-dessus est destiné à fournir à Google du contexte sur ce champ.

tripId

string

Cet ID permet de regrouper les billets si l'utilisateur a enregistré plusieurs billets pour le même trajet.

ticketStatus

enum (TicketStatus)

État du billet. Pour les états qui affectent l'affichage, utilisez plutôt le champ state.

customTicketStatus

object (LocalizedString)

État personnalisé à utiliser pour la valeur de l'état de la demande lorsque ticketStatus ne fournit pas l'option appropriée. ticketStatus et customTicketStatus ne doivent pas être définis en même temps.

concessionCategory

enum (ConcessionCategory)

Catégorie de réduction du billet.

customConcessionCategory

object (LocalizedString)

Catégorie de concession personnalisée à utiliser lorsque concessionCategory ne fournit pas la bonne option. concessionCategory et customConcessionCategory ne doivent pas être définis en même temps.

ticketRestrictions

object (TicketRestrictions)

Informations sur les restrictions liées à l'utilisation de ce billet. Par exemple, les jours de la semaine où elle doit être utilisée ou les itinéraires autorisés.

purchaseDetails

object (PurchaseDetails)

Détails de l'achat de ce billet.

ticketLeg

object (TicketLeg)

Un seul segment de billet contient des informations sur le départ et l'arrivée, ainsi que sur l'embarquement et les sièges. Si vous devez spécifier plusieurs segments, utilisez plutôt le champ ticketLegs. ticketLeg et ticketLegs ne doivent pas être définis en même temps.

ticketLegs[]

object (TicketLeg)

Chaque billet peut contenir une ou plusieurs sections. Chaque segment contient des informations sur le départ et l'arrivée, ainsi que sur l'embarquement et les sièges. Si vous ne souhaitez spécifier qu'un seul trajet, utilisez plutôt le champ ticketLeg. ticketLeg et ticketLegs ne doivent pas être définis en même temps.

hexBackgroundColor

string

Couleur d'arrière-plan de la fiche. Si cette couleur d'arrière-plan 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 au format hexadécimal, tel que #ffcc00. Vous pouvez également utiliser la version abrégée du triplet RVB (#rgb), telle que #fc0.

tripType

enum (TripType)

Obligatoire. Type de trajet représenté par cet objet Transport. Permet de déterminer le titre de la carte et/ou le symbole à utiliser entre l'adresse de départ et la destination.

id

string

Obligatoire. Identifiant unique d'un objet Cet ID doit être unique parmi tous les objets d'un émetteur. Cette valeur doit respecter le format issuer ID.identifier, où le premier est émis par Google et le second 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, doit déjà exister 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 de messages affichés dans l'application. Tous les utilisateurs de cet objet recevront les messages qui lui sont associés. Le nombre maximal de ces champs est de 10.

validTimeInterval

object (TimeInterval)

Période pendant laquelle cet objet sera active et pourra ê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 de 1 au niveau de l'objet et de 1 au niveau de l'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.

activationStatus

object (ActivationStatus)

État d'activation de l'objet. Obligatoire si activationOptions est défini pour la classe.

rotatingBarcode

object (RotatingBarcode)

Type et valeur du code-barres rotatif.

deviceContext

object (DeviceContext)

Contexte de l'appareil associé à l'objet.

heroImage

object (Image)

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

groupingInfo

object (GroupingInfo)

Information qui gère le regroupement des cartes.

passConstraints

object (PassConstraints)

Transmettez les contraintes de 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 s'appliquent qu'aux heures d'enregistrement. Si les restrictions ont changé après qu'un utilisateur a enregistré la carte, les nouvelles restrictions ne s'appliquent pas à une carte déjà enregistrée.

linkedObjectIds[]

string

Les linkedObjectIds sont une liste d'autres objets tels que des billets pour des événements, des cartes de fidélité, des offres, des cartes génériques, des cartes cadeaux, des titres de transport et des cartes d'embarquement qui doivent être automatiquement associés à cet objet de transport en commun. Si un utilisateur a enregistré cette carte de transport en commun, ces linkedObjectIds sont automatiquement transmis à 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.

PassengerType

Enums
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

Ancien alias de SINGLE_PASSENGER. Obsolète.

MULTIPLE_PASSENGERS
multiplePassengers

Ancien alias de MULTIPLE_PASSENGERS. Obsolète.

TicketStatus

Enums
TICKET_STATUS_UNSPECIFIED
USED
used

Ancien alias de USED. Obsolète.

REFUNDED
refunded

Ancien alias de REFUNDED. Obsolète.

EXCHANGED
exchanged

Ancien alias de EXCHANGED. Obsolète.

ConcessionCategory

Enums
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

Ancien alias de ADULT. Obsolète.

CHILD
child

Ancien alias de CHILD. Obsolète.

SENIOR
senior

Ancien alias de SENIOR. Obsolète.

TicketRestrictions

Représentation JSON
{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}
Champs
routeRestrictions

object (LocalizedString)

Restrictions concernant les itinéraires possibles. Il peut s'agir, par exemple, de la chaîne "Trains CrossCountry réservés uniquement".

routeRestrictionsDetails

object (LocalizedString)

Plus d'informations sur le routeRestrictions ci-dessus.

timeRestrictions

object (LocalizedString)

Restrictions concernant les horaires d'utilisation de ce billet

otherRestrictions

object (LocalizedString)

Restrictions supplémentaires qui ne relèvent pas des catégories "itinéraire" ou "heure".

PurchaseDetails

Représentation JSON
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}
Champs
purchaseReceiptNumber

string

Numéro/identifiant du reçu permettant de suivre l'achat du billet via l'organisme qui l'a vendu.

purchaseDateTime

string

Date/Heure d'achat du billet

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 déroulait à New York, cela correspondrait à 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 informations sur un éventuel décalage.

Sans informations de décalage, certaines fonctionnalités avancées peuvent ne pas être disponibles.

accountId

string

ID du compte utilisé pour acheter le billet.

confirmationCode

string

Code de confirmation de l'achat. Il peut s'agir de la même valeur pour plusieurs demandes différentes. Il permet de regrouper les demandes.

ticketCost

object (TicketCost)

Coût du billet.

TicketCost

Représentation JSON
{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}
Champs
faceValue

object (Money)

Valeur faciale du billet.

purchasePrice

object (Money)

Prix d'achat réel du billet, après taxes et/ou remises.

discountMessage

object (LocalizedString)

Message décrivant tout type de remise appliquée.

TicketLeg

Représentation JSON
{
  "originStationCode": string,
  "originName": {
    object (LocalizedString)
  },
  "destinationStationCode": string,
  "destinationName": {
    object (LocalizedString)
  },
  "departureDateTime": string,
  "arrivalDateTime": string,
  "fareName": {
    object (LocalizedString)
  },
  "carriage": string,
  "platform": string,
  "zone": string,
  "ticketSeat": {
    object (TicketSeat)
  },
  "ticketSeats": [
    {
      object (TicketSeat)
    }
  ],
  "transitOperatorName": {
    object (LocalizedString)
  },
  "transitTerminusName": {
    object (LocalizedString)
  }
}
Champs
originStationCode

string

Code de la station de départ. Cet attribut est obligatoire si destinationStationCode est présent ou si originName ne l'est pas.

originName

object (LocalizedString)

Nom de la station de départ. Cet attribut est obligatoire si desinationName est présent ou si originStationCode ne l'est pas.

destinationStationCode

string

Code de la station de destination.

destinationName

object (LocalizedString)

Nom de la destination.

departureDateTime

string

Date/Heure de départ Ce paramètre est obligatoire si aucun intervalle de validité n'est défini sur l'objet de transport en commun.

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 déroulait à New York, cela correspondrait à 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 informations sur un éventuel décalage.

La partie de la date/heure sans le décalage est considérée comme la "date/heure locale". Il doit s'agir de la date/heure locale de la gare de départ. Par exemple, si le départ a lieu à 20h00 le 5 juin 2018 à la gare de départ, la partie date/heure locale doit être 2018-06-05T20:00:00. Si la date/heure locale de la station d'origine est 4 heures en avance sur l'heure UTC, un décalage de -04:00 peut être ajouté.

Sans informations de décalage, certaines fonctionnalités avancées peuvent ne pas être disponibles.

arrivalDateTime

string

Date/Heure d'arrivée

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 déroulait à New York, cela correspondrait à 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 informations sur un éventuel décalage.

La partie de la date/heure sans le décalage est considérée comme la "date/heure locale". Il doit s'agir de la date/heure locale de la borne de destination. Par exemple, si l'événement se produit à 20h le 5 juin 2018 à la gare de destination, la partie date/heure locale doit être 2018-06-05T20:00:00. Si la date/heure locale de la borne de destination est 4 heures en avance sur l'heure UTC, un décalage de -04:00 peut être ajouté.

Sans informations de décalage, certaines fonctionnalités avancées peuvent ne pas être disponibles.

fareName

object (LocalizedString)

Brève description/nom du tarif pour cet itinéraire. (par exemple, "Utilisation unique à tout moment").

carriage

string

Nom/numéro du train ou du bateau que le passager doit prendre.

platform

string

Plate-forme ou porte où le passager peut monter dans la voiture.

zone

string

Zone d'embarquement sur la plate-forme.

ticketSeat

object (TicketSeat)

Siège réservé pour le ou les passagers. Si vous devez spécifier plusieurs sièges, utilisez plutôt le champ ticketSeats. ticketSeat et ticketSeats ne doivent pas être définis en même temps.

ticketSeats[]

object (TicketSeat)

Siège réservé pour le ou les passagers. Si vous ne souhaitez spécifier qu'un seul siège, utilisez plutôt le champ ticketSeat. ticketSeat et ticketSeats ne doivent pas être définis en même temps.

transitOperatorName

object (LocalizedString)

Nom de l'opérateur de transports en commun qui gère cette partie du trajet.

transitTerminusName

object (LocalizedString)

Gare terminus ou destination du train/bus/etc.

TicketSeat

Représentation JSON
{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}
Champs
fareClass

enum (FareClass)

Classe tarifaire du siège pour lequel le billet a été émis.

customFareClass

object (LocalizedString)

Classe tarifaire personnalisée à utiliser si aucun fareClass ne s'applique. fareClass et customFareClass ne doivent pas être définis en même temps.

coach

string

Identifiant du wagon dans lequel se trouve le siège du billet. par exemple, "10"

seat

string

Identifiant de l'emplacement du siège pour lequel le billet a été émis. par exemple, "42". Si aucun identifiant spécifique n'est défini, utilisez plutôt seatAssigment.

seatAssignment

object (LocalizedString)

Siège attribué au passager. par exemple, "Aucun siège spécifique". À utiliser lorsqu'aucun identifiant spécifique n'est à utiliser dans seat.

FareClass

Enums
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

Ancien alias de ECONOMY. Obsolète.

FIRST
first

Ancien alias de FIRST. Obsolète.

BUSINESS
business

Ancien alias de BUSINESS. Obsolète.

TripType

Enums
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

Ancien alias de ROUND_TRIP. Obsolète.

ONE_WAY
oneWay

Ancien alias de ONE_WAY. Obsolète.

ActivationStatus

État d'activation de l'objet. Ce champ inclut l'état d'activation si la valeur est compatible avec l'activation.

Représentation JSON
{
  "state": enum (State)
}
Champs
state

enum (State)

État

Enums
UNKNOWN_STATE
NOT_ACTIVATED "Non activé" (état par défaut)
not_activated

Ancien alias de NOT_ACTIVATED. Obsolète.

ACTIVATED Activation
activated

Ancien alias de ACTIVATED. Obsolète.

DeviceContext

Contexte de l'appareil associé à l'objet.

Représentation JSON
{
  "deviceToken": string
}
Champs
deviceToken

string

Si ce champ est défini, les informations d'utilisation ne sont renvoyées qu'à l'appareil en question une fois l'objet activé. Cette chaîne ne doit pas être utilisée comme identifiant stable pour suivre l'appareil d'un utilisateur. Elle peut varier pour les différents billets d'un même appareil, voire pour différentes activations sur un même appareil. Lorsque le champ est défini, les appelants doivent également définir hasLinkedDevice sur l'objet qui est en cours d'activation.

Méthodes

addmessage

Ajoute un message à l'objet de transports en commun référencé par l'ID d'objet donné.

get

Renvoie l'objet de transports en commun associé à l'ID d'objet donné.

insert

Insère un objet de transports en commun avec l'ID et les propriétés donnés.

list

Renvoie la liste de tous les objets de transport en commun pour un ID d'émetteur donné.

patch

Met à jour l'objet de transports en commun référencé par l'ID d'objet donné.

update

Met à jour l'objet de transports en commun référencé par l'ID d'objet donné.