קודי שגיאה וחריגים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
תגובות לשגיאות ב-API
הטבלה הבאה מסבירה קודי שגיאה שייתכן שהוחזרו על ידי Google Wallet API, הסיבות האפשריות והפתרונות שלהם.
| חריגה |
הודעה לדוגמה |
הצעה |
| 400 – BadRequestהחרגה |
הבקשה מכילה ארגומנט לא חוקי. מזהה המשאב לא תקין: {1234567891234567899 - ABCD1234567}. |
בודקים את מבנה הנתונים לגבי הסוג, הפורמט והאורך, ומעבירים את הארגומנט הנכון. |
| 403 – Permissiondeniedהחרגה |
ההרשאה נדחתה |
מוודאים שכתובת האימייל הנכונה של חשבון השירות היא משתמש מורשה במסוף Business Pay וב-Wallet. |
| 404 – לא נמצא חריג |
אובייקט Wallet {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} לא נמצא. |
מבצעים GET על מזהה האובייקט לפני שמנסים לפני בקשת PATCH או PUT, כדי לוודא שיש אובייקט לעדכון ושהוא העדכני ביותר. |
| 404 – IssuerClassNotFoundהחרגה |
סיווג האובייקט של Google Wallet {1234567891234567899.ABCD.1234567} לא נמצא. |
כשאתם מבצעים עדכון, הקפידו לשלוח בקשת GET לפני בקשת PATCH או PUT, כדי לוודא שיש לכם מחלקה שמציינת שהיא המחלקה האחרונה. כמו כן, צריך לוודא שנעשה שימוש נכון במטען הייעודי (payload) (אובייקט ומחלקה) בבקשה. |
| 409 - alreadyExists לחריגה |
Class Object Class {1234567891234567899.ABCD.1234567} כבר קיים. |
לפני שמנסים ליצור את אותו מזהה כיתה, צריך לבצע GET את מזהה הכיתה. אם המשאב קיים, כדאי להשתמש ב-PATCH או ב-PUT.. |
הודעות שגיאה מבוססות-אינטרנט
אם משהו משתבש כשמנסים לשמור כרטיס באמצעות הקישור 'הוספה ל-Google Wallet', תוצג הודעת שגיאה אינפורמטיבית שתעזור לכם לנפות באגים. ההודעות האלה מוצגות רק למשתמשים עם תפקיד 'מפתח' או 'אדמין' בחשבון של המנפיק.
דוגמה לסוג הודעת השגיאה שייתכן שתוצג:
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[[["\u003cp\u003eThis page explains the various error codes returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException.\u003c/p\u003e\n"],["\u003cp\u003eEach error code is accompanied by a description, potential causes, and suggestions for resolution, such as data validation, permission checks, and resource verification.\u003c/p\u003e\n"],["\u003cp\u003eBefore 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.\u003c/p\u003e\n"],["\u003cp\u003eFor 'Add to Google Wallet' links, web-based error messages are displayed to developers and admins to aid in debugging issues during pass saving.\u003c/p\u003e\n"],["\u003cp\u003eThese messages provide insights into the problem, helping developers understand and resolve issues effectively.\u003c/p\u003e\n"]]],["The Google Wallet API returns specific error codes: 400 (BadRequestException) indicates an invalid argument, requiring checks on data structure. 403 (PermissionDeniedException) means the service account lacks authorization. 404 (NotFoundException) signals a missing Wallet Object or Class, needing a GET request before PATCH/PUT actions. 409 (AlreadyExistsException) indicates an existing class, suggesting a GET request and potential PATCH/PUT instead of creating it again. Web errors are displayed to developers and admins.\n"],null,["# Error codes and exceptions\n\nAPI error responses\n-------------------\n\nThe following table explains error codes that mayn be returned by the Google Wallet API, their possible causes, and solutions.\n\n| Exception | Example Message | Suggestion |\n|------------------------------------|---------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 400 - BadRequestException | Request contains an invalid argument. Invalid resource ID: {1234567891234567899 - ABCD1234567}. | Check the data structure for type, format and length and pass the correct argument. |\n| 403 - PermissionDeniedException | Permission Denied | Ensure the correct [Service Account](https://developers.google.com/wallet/retail/loyalty-cards/web/prerequisites#4.-authorize-the-service-account) email is an authorized user within your Business Pay and Wallet Console. |\n| 404 - NotFoundException | Wallet Object {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} not found. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Object ID before trying before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have an object to update and that it's the latest. |\n| 404 - IssuerClassNotFoundException | Wallet Object Class {1234567891234567899.ABCD.1234567} not found. | When performing an update , ensure you do a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) request before a [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) request to ensure you have a class to reference that it's the latest class. Also ensure the correct payload (object and class) is being used in the request correctly. |\n| 409 - AlreadyExistsException | Wallet Object Class {1234567891234567899.ABCD.1234567} already exists. | Perform a [GET](https://developers.google.com/wallet/generic/rest/v1/genericclass/get#http-request) on the Class ID before trying to create the same Class ID. If the resource exists you may want to use [PATCH](https://developers.google.com/wallet/generic/rest/v1/genericclass/patch#http-request) or [PUT.](https://developers.google.com/wallet/generic/rest/v1/genericclass/update#http-request) |\n\nWeb-based error messages\n------------------------\n\nIf something goes wrong when you attempt to save a pass using an 'Add to Google Wallet' link, you will be shown an informative error message to help you debug. These messages are only shown to users that have the 'Developer' or 'Admin' role for the associated Issuer account.\n\nHere is an example of the type of error message that might be displayed:"]]
