رموز الخطأ والاستثناءات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الردود على أخطاء واجهة برمجة التطبيقات
يوضّح الجدول التالي رموز الخطأ التي قد تعرضها واجهة Google Wallet API والأسباب المحتمَلة لها وحلولها.
| استثناء |
مثال على رسالة |
الاقتراح |
| 400 - BadRequestException |
يحتوي الطلب على وسيطة غير صالحة. معرّف المورد غير صالح: {1234567891234567899 - ABCD1234567}. |
تحقق من هيكل البيانات لمعرفة النوع والتنسيق والطول وتمرير الوسيطة الصحيحة. |
| 403 - PermissionDeniedException |
تم رفض الإذن |
تأكَّد من أنّ عنوان البريد الإلكتروني الصحيح لحساب الخدمة هو مستخدم مفوّض في Business Pay و"وحدة التحكّم في المحفظة". |
| 404 - NotFoundException |
لم يتم العثور على عنصر المحفظة {1234567891234567899.عيّنةClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3}. |
نفِّذ عملية GET على رقم تعريف العنصر قبل المحاولة قبل طلب PATCH أو PUT للتأكُّد من أنّ لديك عنصر تريد تعديله وأنّه هو الأحدث. |
| 404 - جهة إصدار المنتج فئة عدم العثور على استثناء |
فئة عنصر المحفظة {1234567891234567899.ABCD.1234567} غير موجودة. |
عند إجراء أي تعديل، احرِص على تنفيذ طلب GET قبل طلب PATCH أو PUT للتأكُّد من أنّه لديك صف للإشارة إلى أنّه آخر فئة. عليك التأكّد أيضًا من استخدام الحمولة الصحيحة (الكائن والفئة) في الطلب بشكل صحيح. |
| 409 - AlreadyExistsException |
فئة عنصر المحفظة {1234567891234567899.ABCD.1234567} موجودة بالفعل. |
نفِّذ عملية GET على رقم تعريف الفئة قبل محاولة إنشاء رقم تعريف الصف نفسه. في حال توفُّر المورد، قد تحتاج إلى استخدام PATCH أو PUT. |
رسائل خطأ مستندة إلى الويب
إذا حدث خطأ عند محاولة حفظ بطاقة باستخدام الرابط "الإضافة إلى محفظة Google"، ستظهر لك رسالة خطأ مفيدة لمساعدتك في تصحيح الأخطاء. لا تظهر هذه الرسائل إلا للمستخدمين الحاصلين على دور "المطوّر" أو "المشرف" في حساب "جهة الإصدار" المرتبط.
في ما يلي مثال على نوع رسالة الخطأ التي قد يتم عرضها:
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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."]]],["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"]]
