לספק ל-Google מידע על עדכון של כרטיס פרטי שממתין. כך Google תוכל לשלוח את ההתראה על העדכון למכשיר שבו הכרטיס הזה מאוחסן כרגע.
בקשת HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
---|
{ "externalPassId": string, "updatedPassJwtSignature": string, "updateUri": string } |
שדות | |
---|---|
externalPassId |
חובה. מזהה מלא של הכרטיס שרוצים להודיע עליו לבעלי הכרטיס. הפורמט הוא <issuerId.externalUid>. |
updatedPassJwtSignature |
חובה. החתימה של JWT על הכרטיס המעודכן שהנפיק רוצה להודיע עליו ל-Google. רק מכשירים שמדווחים על חתימה שונה של JWT מאשר החתימה הזו של JWT יקבלו את ההתראה על העדכון. |
updateUri |
חובה. ה-URI של נקודת הקצה של המנפיק, שאליו בעל הכרטיס צריך לעבור כדי לקבל JWT מעודכן של הכרטיס. אסור לכלול בו מידע רגיש. נקודת הקצה צריכה לאמת את המשתמש לפני שהיא מעבירה לו את ה-JWT המעודכן. דוגמה ל-URI של עדכון: https://someissuer.com/update/passId=someExternalPassId |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/wallet_object.issuer