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
必需。发卡机构要向卡券持有人发送通知的卡券的完全限定标识符。格式为 <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
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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`"]]