概要
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
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)
必須。このバーコードのタイプ。
有効な値は次のとおりです。
|
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 に表示できる有効なバーコードがない場合（
まだアップロードされていない場合、現在のバーコードがすべて使用されている）、エラーが表示されます。
メッセージがユーザーに表示されます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eGoogle Wallet now supports Partner-Generated Rotating Barcodes for enhanced security, allowing partners to generate and upload time-limited barcodes directly.\u003c/p\u003e\n"],["\u003cp\u003ePartners can integrate Rotating Barcodes using the \u003ccode\u003erotatingBarcode\u003c/code\u003e object within the Google Wallet Passes API, specifying the barcode type and initial values.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods for batch uploading (\u003ccode\u003etransitobject.uploadrotatingbarcodevalues\u003c/code\u003e) and downloading (\u003ccode\u003etransitobject.downloadrotatingbarcodevalues\u003c/code\u003e) barcode values for ongoing updates.\u003c/p\u003e\n"],["\u003cp\u003eTo ensure continuous barcode availability, it is recommended to upload a day's worth of barcodes daily until a user's pass expires, utilizing the \u003ccode\u003einitialRotatingBarcodeValues\u003c/code\u003e for a smooth initial experience.\u003c/p\u003e\n"],["\u003cp\u003eIf a Rotating Barcode lacks valid values, an error message will be displayed to the user, highlighting the importance of timely barcode updates.\u003c/p\u003e\n"]]],["The Google Wallet Passes API enables partners to use Partner-Generated Rotating Barcodes, enhancing security by having barcodes valid for a short time. Partners can define a `RotatingBarcode` object specifying the barcode `type` and `initialRotatingBarcodeValues`. They then batch upload barcode values using the `transitobject.uploadrotatingbarcodevalues` API endpoint and should upload a day's worth of barcodes each day. Barcode values can be downloaded via `transitobject.downloadrotatingbarcodevalues` for verification. If no valid barcodes are available, an error message is shown.\n"],null,["# Overview\n\nThe Google Wallet Passes API provides the ability for partners to save\n[Rotating\nBarcodes](/wallet/tickets/transit-passes/qr-code/resources/rotating-barcodes) to the Google Wallet. These barcodes are only valid for a short period of time,\nproviding additional security to reduce the risk of barcode screenshotting. The\nbarcodes are generated on device in accordance with\n[RFC 6238](https://www.rfc-editor.org/rfc/rfc6238), with the partner providing the\nsecret key. However, if a partner would rather generate the barcodes themselves, Google provides\nan API such that barcodes can be batch uploaded to Google. These barcodes will then\nbe passed through to users' phones, where they will act just like Rotating Barcodes,\ndisplaying for a short period of time. We refer to this solution as Partner-Generated\nRotating Barcodes.\n\nPartner-Generated Rotating Barcode API\n--------------------------------------\n\nPartner-Generated Rotating Barcodes are created using the same RotatingBarcode\nobject. Only the type is required, although we also recommend creating a small, starter\nset of barcodes (\\~10 minutes worth), and sending them in\n`initialRotatingBarcodeValues`. The partner is responsible for ensuring that there is\nalways a valid barcode ready for the user, and `initialRotatingBarcodeValues` allows\nthe subsequent batch upload call to be asynchronous. \n\n```gdscript\n rotatingBarcode {\n initialRotatingBarcodeValues: object (RotatingBarcodeValues),\n type: enum (BarcodeType),\n }\n```\n\n| Field | Description |\n|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `initialRotatingBarcodeValues` | `object (`[RotatingBarcodeValues](#RotatingBarcodeValues)`)` The values to encode in the barcode. At least one value is required. These initial barcodes are meant to bridge the gap between when the user first acquires their pass, and when the subsequent batch upload call is made. |\n| `type` | `enum (`[BarcodeType](/wallet/tickets/transit-passes/qr-code/rest/v1/BarcodeType)`)` Required. The type of this barcode. Acceptable values are: - `QR_CODE` - `PDF_417` \u003cbr /\u003e |\n\nRotatingBarcodeValues\n\n| Field | Description |\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `startDateTime` | `string` The date/time the first barcode is valid from. Barcodes will be rotated through using `periodMillis`. This is an ISO 8601 extended format date/time, with an offset. |\n| `values[]` | `string` The values to encode in the barcode. At least one value is required. There is no maximum number of values, but note that the size of the request body cannot exceed 5MB. |\n| `periodMillis` | `number` The amount of time each barcode is valid for. |\n\nBatch updating barcode values\n-----------------------------\n\nAfter the RotatingBarcode object has been created, we recommend uploading a day's\nworth of barcodes, every day, until the user's pass expires. This can be done with the\nfollowing REST API endpoint.\n\n### Method: transitobject.uploadrotatingbarcodevalues\n\nUploads rotating barcode values to the transit object referenced by the given object ID.\n\n#### HTTP request\n\n`POST\nhttps://walletobjects.googleapis.com/upload/walletobjects/v1/transitObject/{resourc\neId}/uploadRotatingBarcodeValues`\n\n#### Path parameters\n\n| Parameter | Description |\n|--------------|-----------------------------------------------|\n| `resourceId` | `string` The unique identifier for an object. |\n\n#### Request body\n\nThe request body (which cannot exceed 5MB) contains an instance of\n[RotatingBarcodeValues](#RotatingBarcodeValues).\n\n### Method: transitobject.downloadrotatingbarcodevalues\n\nDownloads rotating barcode values for the transit object referenced by the given object\nID. This is useful if partners want to verify the latest batch.\n\n#### HTTP request\n\n`GET\nhttps://walletobjects.googleapis.com/walletobjects/v1/transitObject/{resourceId}/do\nwnloadRotatingBarcodeValues?alt=media`\n\n#### Path parameters\n\n| Parameter | Description |\n|--------------|-----------------------------------------------|\n| `resourceId` | `string` The unique identifier for an object. |\n\nFallback mechanisms\n-------------------\n\nNote that if an otherwise-valid RotatingBarcode has no valid barcodes to display (they haven't been uploaded yet, or all the current barcodes have been used), an error message will be shown to the user."]]
