تحديد مشاكل رموز الخطأ وحلّها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة بعض رموز الأخطاء الشائعة التي قد تواجهها أثناء استخدام
Directory API.
503 Service unavailable
أثناء استخدام طريقة nextPageToken
لاسترداد قائمة كبيرة من المستخدمين أو
الأجهزة، قد يظهر لك هذا الخطأ إذا استغرق الطلب أكثر من 60
دقيقة. يرجع سبب هذا الخطأ إلى قيود واجهة برمجة التطبيقات Directory API.
في ما يلي ردّ الخطأ الكامل:
{
"error": {
"code": 503,
"message": "Service unavailable. Please try again",
"errors": [
{
"message": "Service unavailable. Please try again",
"domain": "global",
"reason": "backendError"
}
]
}
}
لتجنُّب حدوث هذا الخطأ، يمكنك تقليل عدد الأجهزة أو المستخدمين من خلال إجراء طلبات بحث
باستخدام الفلاتر كي لا تستغرق العمليات الفردية أكثر من ساعة لإكمالها. تتطلّب هذه الطريقة إجراء طلبات بحث متعددة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة البحث عن الأجهزة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Troubleshoot error codes\n\nThis page describes some common error codes that you might encounter while using\nthe Directory API.\n\n`503 Service unavailable`\n-------------------------\n\nWhile using the `nextPageToken` method to retrieve a large list of users or\ndevices, you might encounter this error if the request takes longer than 60\nminutes. This error is due to a limitation of the Directory API.\n\nThe following is the full error response: \n\n```\n{\n \"error\": {\n \"code\": 503,\n \"message\": \"Service unavailable. Please try again\",\n \"errors\": [\n {\n \"message\": \"Service unavailable. Please try again\",\n \"domain\": \"global\",\n \"reason\": \"backendError\"\n }\n ]\n }\n}\n```\n\nTo avoid this error, you can reduce the number of devices or users by querying\nwith filters so that the individual operations don't take over an hour to\ncomplete. This approach requires multiple queries. For more information, see\n[Search for devices](/workspace/admin/directory/v1/guides/search-devices)."]]