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
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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`"]]
