概要

Google Wallet Passes API には、 ローテーション バーコードを Google ウォレットに送信します。これらのバーコードは短期間のみ有効です。 セキュリティが強化され、バーコードのスクリーンショット撮影のリスクを軽減できます。「 に従って、デバイス上に RFC 6238( されます。パートナー様がバーコードを自分で生成することをご希望の場合は、 バーコードを Google に一括アップロードできる API です。これらのバーコードが ユーザーの回転バーコードのように機能し、 短時間表示されますGoogle では、このソリューションを「パートナー様が生成」と呼んでいます。 バーコードのローテーション。

パートナーが生成したローテーション バーコードの API

パートナーが生成したローテーション バーコードは、同じ RotatingBarcode を使用して作成されます。 渡されます。タイプのみは必須ですが、小さな開始条件の作成もおすすめします。 バーコードのセット(約 10 分相当)をスキャンし、 initialRotatingBarcodeValues。パートナー様は、 ユーザーが常に有効なバーコードを提示し、initialRotatingBarcodeValues で 後続の一括アップロード呼び出しは非同期になります

  rotatingBarcode {
    initialRotatingBarcodeValues: object (RotatingBarcodeValues),
    type: enum (BarcodeType),
  }
フィールド 説明
initialRotatingBarcodeValues

object (RotatingBarcodeValues)

バーコードでエンコードする値。少なくとも 1 つの値が必要です。これらのイニシャルは、 バーコードは、ユーザーがパスを初めて取得する時点と、 後続の一括アップロードの呼び出し時に 発生します

type

enum (BarcodeType)

必須。このバーコードのタイプ。

有効な値は次のとおりです。

  • QR_CODE
  • PDF_417

RotatingBarcodeValues
フィールド 説明
startDateTime

string

最初のバーコードが有効になる日付/時刻。バーコードは次の順にローテーションされます: periodMillis を使用します。

オフセット付きの ISO 8601 拡張形式の日付/時刻です。

values[]

string

バーコードでエンコードする値。値を少なくとも 1 つ指定してください。

値の数に上限はありませんが、リクエスト本文のサイズは 5MB 以下。

periodMillis

number

各バーコードの有効期間。

バーコード値の一括更新

RotatingBarcode オブジェクトを作成したら、その日の 100% のバーコードが毎日、ユーザーのパスの有効期限が切れるまで送信されます。これを行うには、 移動することもできます

メソッド: transitobject.uploadrotatingbarcodevalues

指定されたオブジェクト ID の交通機関オブジェクトに、ローテーション バーコードの値をアップロードします。

HTTP リクエスト

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

パスパラメータ

パラメータ 説明
resourceId

string

オブジェクトの一意の識別子。

リクエスト本文

リクエスト本文(5 MB 以下)には、 RotatingBarcodeValues

メソッド: transitobject.downloadrotatingbarcodevalues

指定されたオブジェクトによって参照される交通機関オブジェクトのローテーション バーコード値をダウンロードします。 あります。これは、パートナーが最新のバッチを確認する場合に便利です。

HTTP リクエスト

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

パスパラメータ

パラメータ 説明
resourceId

string

オブジェクトの一意の識別子。

フォールバック メカニズム

それ以外の場合は有効な RotatingBarcode に表示できる有効なバーコードがない場合( まだアップロードされていない場合、現在のバーコードがすべて使用されている)、エラーが表示されます。 メッセージがユーザーに表示されます。