Method: walletobjects.v1.privateContent.setPassUpdateNotice
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
לספק ל-Google מידע על עדכון של כרטיס פרטי שממתין. כך Google תוכל לשלוח את ההתראה על העדכון למכשיר שבו הכרטיס הזה מאוחסן כרגע.
בקשת HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"externalPassId": string,
"updatedPassJwtSignature": string,
"updateUri": string
} |
| שדות |
externalPassId |
string
חובה. מזהה מלא של הכרטיס שרוצים להודיע עליו לבעלי הכרטיס. הפורמט הוא <issuerId.externalUid>.
|
updatedPassJwtSignature |
string
חובה. החתימה של JWT על הכרטיס המעודכן שהנפיק רוצה להודיע עליו ל-Google. רק מכשירים שמדווחים על חתימה שונה של JWT מאשר החתימה הזו של JWT יקבלו את ההתראה על העדכון.
|
updateUri |
string
חובה. ה-URI של נקודת הקצה של המנפיק, שאליו בעל הכרטיס צריך לעבור כדי לקבל JWT מעודכן של הכרטיס. אסור לכלול בו מידע רגיש. נקודת הקצה צריכה לאמת את המשתמש לפני שהיא מעבירה לו את ה-JWT המעודכן. דוגמה ל-URI של עדכון: https://someissuer.com/update/passId=someExternalPassId
|
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/wallet_object.issuer
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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`"]]
