کدهای خطا و استثنائات
پاسخ های خطای API
جدول زیر کدهای خطایی را که ممکن است توسط Google Wallet API بازگردانده شود، علل احتمالی آنها و راه حل ها توضیح می دهد.
| استثنا | پیام نمونه | پیشنهاد |
|---|
| 400 - BadRequestException | درخواست حاوی یک آرگومان نامعتبر است. شناسه منبع نامعتبر: {1234567891234567899 - ABCD1234567}. | ساختار داده را از نظر نوع، قالب و طول بررسی کنید و آرگومان صحیح را ارسال کنید. |
| 403 - PermissionDeniedException | اجازه رد شد | مطمئن شوید که ایمیل حساب سرویس صحیح یک کاربر مجاز در کنسول Business Pay و Wallet شما باشد. |
| 404 - NotFoundException | Wallet Object {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} یافت نشد. | قبل از انجام یک درخواست PATCH یا PUT ، یک GET روی شناسه Object انجام دهید تا مطمئن شوید که یک شی برای به‌روزرسانی دارید و آخرین مورد است. |
| 404 - IssuerClassNotFoundException | کلاس شی Wallet {1234567891234567899.ABCD.1234567} یافت نشد. | هنگام انجام به‌روزرسانی، مطمئن شوید که یک درخواست GET قبل از درخواست PATCH یا PUT انجام می‌دهید تا مطمئن شوید که کلاسی برای ارجاع به اینکه آخرین کلاس است دارید. همچنین مطمئن شوید که بار صحیح (شی و کلاس) در درخواست به درستی استفاده می شود. |
| 409 - AlreadyExistsException | کلاس شی Wallet {1234567891234567899.ABCD.1234567} از قبل وجود دارد. | قبل از تلاش برای ایجاد همان شناسه کلاس، یک GET روی شناسه کلاس انجام دهید. اگر منبع وجود دارد، ممکن است بخواهید از PATCH یا PUT استفاده کنید. |
پیام های خطای مبتنی بر وب
اگر هنگام تلاش برای ذخیره گذرنامه با استفاده از پیوند «افزودن به Google Wallet» مشکلی پیش بیاید، یک پیام خطای آموزنده برای کمک به رفع اشکال به شما نشان داده می شود. این پیام‌ها فقط به کاربرانی نشان داده می‌شوند که نقش «توسعه‌دهنده» یا «مدیر» را برای حساب صادرکننده مرتبط دارند.
در اینجا نمونه ای از نوع پیام خطایی است که ممکن است نمایش داده شود:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-02-28 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-02-28 بهوقت ساعت هماهنگ جهانی."],[[["This page explains the different error codes that may be returned by the Google Wallet API, including BadRequestException, PermissionDeniedException, NotFoundException, IssuerClassNotFoundException, and AlreadyExistsException."],["Each error code has an explanation for the possible causes and suggestions for how to resolve the issue."],["The table provides example messages for each exception, and links to relevant documentation for further troubleshooting."],["Web-based error messages are shown to users with 'Developer' or 'Admin' roles when saving a pass using the 'Add to Google Wallet' link to assist with debugging."],["These informative error messages provide detailed information about the issue, helping users identify and resolve problems quickly."]]],["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"]]
