Method: walletobjects.v1.privateContent.setPassUpdateNotice
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
向 Google 提供有關私人證件更新的資訊。這樣 Google 就能向目前持有此票證的裝置提供更新通知。
HTTP 要求
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
{
"externalPassId": string,
"updatedPassJwtSignature": string,
"updateUri": string
} |
欄位 |
externalPassId |
string
必要欄位。發卡機構要通知票證持有人的票證完整 ID。格式為 <issuerId.externalUid>。
|
updatedPassJwtSignature |
string
必要欄位。發卡機構要通知 Google 的更新票證 JWT 簽名。只有回報的 JWT 簽名與此 JWT 簽名不同的裝置,才會收到更新通知。
|
updateUri |
string
必要欄位。票證持有人必須遵循的核發者端點 URI,才能接收更新的票證 JWT。且不得包含任何機密資訊。端點必須先驗證使用者,才能將更新後的 JWT 提供給使用者。更新 URI 範例:https://someissuer.com/update/passId=someExternalPassId
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/wallet_object.issuer
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Method: walletobjects.v1.privateContent.setPassUpdateNotice\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nProvide Google with information about awaiting private pass update. This will allow Google to provide the update notification to the device that currently holds this pass.\n\n### HTTP request\n\n`POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------|\n| ``` { \"externalPassId\": string, \"updatedPassJwtSignature\": string, \"updateUri\": string } ``` |\n\n| Fields ||\n|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `externalPassId` | `string` Required. A fully qualified identifier of the pass that the issuer wants to notify the pass holder(s) about. Formatted as \\\u003cissuerId.externalUid\\\u003e. |\n| `updatedPassJwtSignature` | `string` Required. The JWT signature of the updated pass that the issuer wants to notify Google about. Only devices that report a different JWT signature than this JWT signature will receive the update notification. |\n| `updateUri` | `string` Required. The issuer endpoint URI the pass holder needs to follow in order to receive an updated pass JWT. It can not contain any sensitive information. The endpoint needs to authenticate the user before giving the user the updated JWT. Example update URI \u003chttps://someissuer.com/update/passId=someExternalPassId\u003e |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/wallet_object.issuer`"]]