Présentation

L'API Google Wallet Passes permet aux partenaires d'enregistrer Rotation des codes-barres à Google Wallet. Ces codes-barres ne sont valides que pendant une courte période, offrant une sécurité supplémentaire pour réduire le risque de capture d'écran de codes-barres. La des codes-barres sont générés sur l'appareil conformément aux RFC 6238, où le partenaire fournissant les clé secrète. Toutefois, si un partenaire préfère générer lui-même les codes-barres, Google fournit une API permettant d'importer des codes-barres sur Google de façon groupée. Ces codes-barres être transmis aux utilisateurs comme les codes-barres rotatifs, pendant une courte période. Nous appelons cette solution "Généré par le partenaire" Codes-barres rotatifs.

API Partner-Generated Rotating Barcode

Les codes-barres rotatifs générés par les partenaires sont créés à l'aide du même . Seul le type est requis, mais nous vous recommandons également de créer un petit déclencheur de code-barres (une dizaine de minutes environ) et les envoyer initialRotatingBarcodeValues Le partenaire est tenu de s'assurer qu'il existe toujours un code-barres valide pour l'utilisateur, et initialRotatingBarcodeValues permet l'appel d'importation groupée suivant pour qu'il soit asynchrone.

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }
Champ Description
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

Valeurs à encoder dans le code-barres. Veuillez indiquer au moins une valeur. Ces initiales Les codes-barres servent à combler l'écart entre le moment où l'utilisateur acquiert sa carte pour la première fois et lors de l'appel d'importation groupée suivant.

type

enum (BarcodeType)

Obligatoire. Type de ce code-barres.

Les valeurs acceptées sont les suivantes :

  • QR_CODE
  • PDF_417

RotatingBarcodeValues
Champ Description
startDateTime

string

Date et heure à partir desquelles le premier code-barres est valide. La rotation des codes-barres avec periodMillis.

Il s'agit d'une date/heure exprimée dans le format étendu de la norme ISO 8601, avec un décalage.

values[]

string

Valeurs à encoder dans le code-barres. Veuillez indiquer au moins une valeur.

Il n'y a pas de nombre maximal de valeurs, mais notez que la taille du corps de la requête ne doit pas dépasser 5 Mo.

periodMillis

number

Durée de validité de chaque code-barres.

Mise à jour groupée des valeurs des codes-barres

Une fois l'objet RotatingBarcode créé, nous vous recommandons d'importer des fichiers d'une journée de codes-barres, tous les jours, jusqu'à l'expiration de la carte de l'utilisateur. Pour ce faire, utilisez suivant le point de terminaison de l'API REST.

Méthode: transitobject.uploadrotatingbarcodevalues

Importe les valeurs des codes-barres rotatifs dans l'objet de transports en commun référencé par l'ID d'objet donné.

Requête HTTP

POST https://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc eId}/uploadRotatingBarcodeValues

Paramètres de chemin d'accès

Paramètre Description
resourceId

string

Identifiant unique d'un objet.

Corps de la requête

Le corps de la requête (qui ne peut pas dépasser 5 Mo) contient une instance de RotatingBarcodeValues.

Méthode: transitobject.downloadrotatingbarcodevalues

Télécharge les valeurs des codes-barres rotatifs de l'objet de transports en commun référencé par l'objet donné. ID. Cette méthode est utile si les partenaires souhaitent vérifier le dernier lot.

Requête HTTP

GET https://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do wnloadRotatingBarcodeValues?alt=media

Paramètres de chemin d'accès

Paramètre Description
resourceId

string

Identifiant unique d'un objet.

Mécanismes de remplacement

Notez que si un RotatingBarcode valide n'a pas de codes-barres valides à afficher (ils n'ont pas encore été importés ou que tous les codes-barres actuels ont été utilisés), une erreur sera présenté à l'utilisateur.