Method: walletobjects.v1.privateContent.setPassUpdateNotice
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اطلاعاتی را در مورد انتظار به‌روزرسانی مجوز خصوصی به Google ارائه دهید. این به Google اجازه می‌دهد تا اعلان به‌روزرسانی را به دستگاهی که در حال حاضر دارای این مجوز است ارائه دهد.
درخواست HTTP
POST https://walletobjects.googleapis.com/walletobjects/v1/privateContent/setPassUpdateNotice
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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`"]]
