Method: walletobjects.v1.privateContent.setPassUpdateNotice
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تقديم معلومات إلى Google حول انتظار تحديث البطاقة الخاصة سيسمح ذلك لشركة Google بتقديم إشعار التحديث إلى الجهاز الذي يتضمّن حاليًا هذه البطاقة.
طلب HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
يستخدِم عنوان URL بنية تحويل ترميز 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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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`"]]
