錯誤代碼和例外狀況
API 錯誤回應
下表說明 Google Wallet API 可能會傳回的錯誤代碼、可能的原因以及解決方法。
| 例外狀況 |
訊息範例 |
建議 |
| 400 - BadRequestException |
要求含有無效引數，資源 ID 無效：{1234567891234567899 - ABCD1234567}。 |
檢查類型、格式和長度的資料結構，並傳遞正確的引數。 |
| 403 - PermissionDeniedException |
權限遭拒 |
確認正確的服務帳戶電子郵件是商家付款和錢包主控台的授權使用者。 |
| 404 - NotFoundException |
找不到錢包物件 {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}。 |
嘗試提出 PATCH 或 PUT 要求之前，請先對物件 ID 執行 GET，確保您有需要更新的物件且是最新版本。 |
| 404 - IssuerClassNotFoundException |
找不到錢包物件類別 {1234567891234567899.ABCD.1234567}。 |
執行更新時，請務必在 PATCH 或 PUT 要求之前執行 GET 要求，確保您的類別可以參照其是最新的類別。此外，也請確認要求中使用的酬載 (物件和類別) 正確無誤。 |
| 409 - OnceExistsException |
已有電子錢包物件類別 {1234567891234567899.ABCD.1234567}。 |
請先對類別 ID 執行 GET，再嘗試建立相同的課程 ID。如果該資源存在，建議您使用 PATCH 或 PUT.。 |
網頁式錯誤訊息
如果您嘗試使用「新增至 Google 錢包」連結儲存票證時發生錯誤，系統會顯示資訊豐富的錯誤訊息，協助您進行偵錯。使用者必須具備相關聯核發者帳戶的「開發人員」或「管理員」角色，才會看到這類訊息。
以下是可能會出現的錯誤訊息類型範例：
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-13 (世界標準時間)。
[null,null,["上次更新時間：2024-08-13 (世界標準時間)。"],[[["This page explains the various error codes returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException."],["Each error code is accompanied by a description, potential causes, and suggestions for resolution, such as data validation, permission checks, and resource verification."],["Before update requests (PATCH or PUT), it's crucial to perform a GET request to ensure the resource exists and you have the latest version to prevent conflicts."],["For 'Add to Google Wallet' links, web-based error messages are displayed to developers and admins to aid in debugging issues during pass saving."],["These messages provide insights into the problem, helping developers understand and resolve issues effectively."]]],[]]
