Method: walletobjects.v1.privateContent.setPassUpdateNotice
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Google Informationen zur ausstehenden Aktualisierung des persönlichen Ausweises zur Verfügung stellen So kann Google die Aktualisierungsbenachrichtigung an das Gerät senden, auf dem sich die Karte bzw. das Ticket gerade befindet.
HTTP-Anfrage
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
{
"externalPassId": string,
"updatedPassJwtSignature": string,
"updateUri": string
} |
Felder |
externalPassId |
string
Erforderlich. Eine vollständig qualifizierte Kennung der Karte bzw. des Tickets, über die der Aussteller die Karten-/Ticketinhaber benachrichtigen möchte. Formatiert als <issuerId.externalUid>.
|
updatedPassJwtSignature |
string
Erforderlich. Die JWT-Signatur der aktualisierten Karte/des aktualisierten Tickets, über die der Aussteller Google informieren möchte. Nur Geräte, die eine andere JWT-Signatur als diese JWT-Signatur melden, erhalten die Updatebenachrichtigung.
|
updateUri |
string
Erforderlich. Die URI des Aussteller-Endpunkts, die der Karteninhaber aufrufen muss, um ein aktualisiertes JWT für die Karte/das Ticket zu erhalten. Sie darf keine vertraulichen Informationen enthalten. Der Endpunkt muss den Nutzer authentifizieren, bevor er ihm das aktualisierte JWT sendet. Beispiel für einen Update-URI: https://someissuer.com/update/passId=someExternalPassId
|
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/wallet_object.issuer
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],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`"]]