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