حالات الخطأ

في حال حدوث خطأ، من المتوقّع أن تعرض "جهة معالجة البيانات" رمز حالة HTTP مع استجابة HTTP يجب أن تتضمّن كائن JSON يتضمّن المزيد من المعلومات عن الخطأ. يجب أن يحتوي نص استجابة الخطأ على مثيل من ErrorResponse.

{
  "errorMessage": string,
  "cause": enum(ErrorCause)
}

يجب أن يتوافق ردّ الخطأ من "هيئة حماية البيانات" مع ما يلي:

• يتجوّل المستخدم حاليًا وتم إيقاف طلب DPA لهذا المستخدم. تعرض DPA الخطأ 403 مع USER_ROAMING كسبب للخطأ.
• تعرض DPA رمز الخطأ 404 NOT_FOUND الذي يشير إلى GTAF بأنّ مفتاح المستخدم غير صالح (أي مفتاح مستخدم غير موجود) مع INVALID_NUMBER.
• تعرض DPA رمز الخطأ 410 GONE مع BAD_CPID كسبب للخطأ، ما يشير إلى GTAF بأنّ على العميل الحصول على مفتاح مستخدم جديد إذا كان key_type = CPID وانتهت صلاحية CPID.
• تعرض "واجهة برمجة التطبيقات الخاصة بالبيانات" رمز الخطأ 501 NOT_IMPLEMENTED الذي يشير إلى أنّها لا تتيح إجراء هذه المكالمة مع سبب الخطأ SERVICE_UNAVAILABLE.
• تعرض خدمة DPA الرمز 429 TOO MANY REQUESTS مع سبب الخطأ TOO_MANY_REQUESTS مع عنوان Retry-After الذي يشير إلى أنّ خدمة GTAF تُجري عددًا كبيرًا جدًا من الطلبات إلى خدمة DPA.
• تعرض "هيئة حماية البيانات" رسالة الخطأ 409 CONFLICT التي تشير إلى أنّه لا يمكن إكمال الطلب بسبب تعارضه مع الحالة الحالية لـ "هيئة حماية البيانات".
• الخدمة غير متاحة مؤقتًا. تعرض "هيئة حماية البيانات" الرمز 503 SERVICE UNAVAILABLE (الخدمة غير متاحة) مع العنوان Retry-After (إعادة المحاولة) الذي يشير إلى الوقت الذي يمكن فيه محاولة إرسال طلب جديد.
• تعرض DPA رمز الخطأ 500 INTERNAL SERVER ERROR لجميع الأخطاء الأخرى غير المحدّدة ERROR_CAUSE_UNSPECIFIED كسبب للخطأ.

في حال حدوث أخطاء أثناء عملية شراء، تشير رموز الخطأ التالية إلى نتائج المعاملات غير الناجحة:

• تعرض "اتفاقية المطوّرين للنشر" رمز الخطأ 400 BAD REQUEST، ما يشير إلى أنّ معرّف الخطة التي تم شراؤها غير صالح.
• تعرض "اتفاقية معالجة البيانات" رمز الخطأ 402 PAYMENT REQUIRED، ما يشير إلى أنّ المستخدم لا يملك رصيدًا كافيًا لإكمال عملية الشراء.
• تعرض "اتفاقية المطوّرين للنشر" رمز الخطأ 409 CONFLICT الذي يشير إلى "أداة Google لتطبيقات Android" (GTAF) بأنّ الخطة المطلوب شراؤها غير متوافقة مع مجموعة المنتجات الحالية للمستخدم. على سبيل المثال، إذا كانت سياسة خطة بيانات مشغّل شبكة الجوّال لا تسمح بدمج الخطط المدفوعة لاحقًا والخطط المدفوعة مسبقًا، ستؤدي محاولة شراء خطة مدفوعة مسبقًا لمستخدم لديه خطة مدفوعة لاحقًا إلى حدوث خطأ 409 CONFLICT.
• تعرض "وكالة الدفع المباشر" رمز الخطأ 403 FORBIDDEN الذي يشير إلى "إطار عمل معاملات Google" (GTAF) بأنّ المعاملة الحالية هي نسخة مكرّرة من معاملة تم إصدارها سابقًا. يجب أن تعرض DPA أسباب الخطأ التالية في الرد:
  • إذا تعذّر إكمال المعاملة السابقة، سيظهر سبب الخطأ الذي يشير إلى سبب تعذّر إكمالها.
  • إذا كانت المعاملة السابقة ناجحة، سيظهر الخطأ DUPLICATE_TRANSACTION.
  • إذا كانت المعاملة السابقة لا تزال في قائمة الانتظار، سيتم عرض REQUEST_QUEUED.