الأخطاء الأساسية

يوضح هذا المستند بعض رموز الأخطاء والرسائل التي تعرضها أداة Google APIs. وتظهر الأخطاء المذكورة هنا تحديدًا في النطاق العام أو التلقائي لأداة Google APIs. ونظرًا لتحديد العديد من واجهات برمجة التطبيقات لنطاقات خاصة بها، تظهر أخطاء خاصة بتلك الواجهات غير موجودة في النطاق العام. وبالنسبة إلى هذه الأخطاء، يتم التعبير عن قيمة السمة domain في استجابة JSON بقيمة خاصة بواجهة برمجة التطبيقات، مثل youtube.parameter.

تسرد هذه الصفحة الأخطاء وفقًا لرموز حالة HTTP، كما هو موضّح في RFC 7231.

يوضح نموذج استجابة JSON التالي طريقة الإبلاغ عن خطأ عام:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

الأخطاء

1. MOVED_PERMANENTLY (301)
2. SEE_OTHER (303)
3. NOT_MODIFIED (304)
4. TEMPORARY_REDIRECT (307)
5. BAD_REQUEST (400)
6. UNAUTHORIZED (401)
7. PAYMENT_REQUIRED (402)
8. FORBIDDEN (403)
9. NOT_FOUND (404)
10. METHOD_NOT_ALLOWED (405)
11. CONFLICT (409)
12. GONE (410)
13. PRECONDITION_FAILED (412)
14. REQUEST_ENTITY_TOO_LARGE (413)
15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
16. EXPECTATION_FAILED (417)
17. PRECONDITION_REQUIRED (428)
18. TOO_MANY_REQUESTS (429)
19. INTERNAL_SERVER_ERROR (500)
20. NOT_IMPLEMENTED (501)
21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

رمز الخطأ	الوصف
movedPermanently	يجب إرسال هذا الطلب والطلبات المستقبلية للعملية نفسها إلى عنوان URL المحدّد في رأس Location الخاص بهذه الاستجابة بدلاً من عنوان URL الذي تم إرسال هذا الطلب إليه.

SEE_OTHER (303)

رمز الخطأ	الوصف
seeOther	تمت معالجة طلبك بنجاح. للحصول على استجابة، يمكنك إرسال طلب GET إلى عنوان URL المحدّد في رأس Location.
mediaDownloadRedirect	تمت معالجة طلبك بنجاح. للحصول على استجابة، يمكنك إرسال طلب GET إلى عنوان URL المحدّد في رأس Location.

NOT_MODIFIED (304)

رمز الخطأ	الوصف
notModified	تعذَّر استيفاء الشرط المحدّد لرأس If-None-Match. توضح هذه الاستجابة أن المستند المطلوب لم يتم تعديله وأنه يجب استرداد نسخة مخزَّنة مؤقتًا من الاستجابة. تحقّق من قيمة رأس طلب HTTP If-None-Match.

TEMPORARY_REDIRECT (307)

رمز الخطأ	الوصف
temporaryRedirect	لمعالجة طلبك، يمكنك إعادة إرساله إلى عنوان URL المحدَّد في رأس Location الخاص بهذه الاستجابة.

BAD_REQUEST (400)

رمز الخطأ	الوصف
badRequest	طلب البيانات من واجهة برمجة التطبيقات غير صالح أو تم تنسيقه بشكل غير صحيح. وبالتالي، لم يتمكَّن خادم واجهة برمجة التطبيقات من فهم الطلب.
badBinaryDomainRequest	طلب النطاق الثنائي غير صالح.
badContent	لا يتوفر نوع محتوى بيانات الطلب أو نوع محتوى لجزء من طلب متعدد الأجزاء.
badLockedDomainRequest	طلب النطاق الذي تم قفله غير صالح.
corsRequestWithXOrigin	يحتوي طلب CORS على رأس XD3 X-Origin، والذي يدل على وجود طلب CORS غير صالح.
endpointConstraintMismatch	تعذّرت تلبية الطلب بسبب عدم تطابقه مع واجهة برمجة التطبيقات المحدّدة. تحقّق من قيمة مسار عنوان URL للتأكّد من صحته.
invalid	تعذَّرت تلبية الطلب لاحتوائه على قيمة غير صالحة. قد تكون هذه القيمة هي قيمة المعلَمة أو قيمة الرأس أو قيمة الخاصية.
invalidAltValue	تحدّد قيمة المعلَمة alt تنسيقًا غير معروف للمُخرجات.
invalidHeader	تعذَّرت تلبية الطلب لاحتوائه على رأس غير صالح.
invalidParameter	تعذَّرت تلبية الطلب لاحتوائه على معلَمة أو قيمة معلَمة غير صالحة. يمكنك الاطّلاع على وثائق واجهة برمجة التطبيقات للتعرُّف على المعلَمات الصالحة لطلبك.
invalidQuery	هذا الطلب غير صالح. يمكنك التحقّق من وثائق واجهة برمجة التطبيقات للتعرُّف على المعلَمات المتوافقة مع الطلب ولمعرفة ما إذا كان الطلب يتضمن أي مجموعة غير صالحة من المعلَمات أو قيمة غير صالحة لمعلَمة. يمكنك التحقّق من قيمة معلَمة طلب q.
keyExpired	انتهت صلاحية مفتاح واجهة برمجة التطبيقات المقدَّم في الطلب، ما يعني أن خادم واجهة برمجة التطبيقات لن يتمكّن من التحقّق من الحد الأقصى للحصة المحددة للتطبيق الذي يقدّم الطلب. يُرجى الرجوع إلى Google Developers Console لمزيد من المعلومات أو للحصول على مفتاح جديد.
keyInvalid	مفتاح واجهة برمجة التطبيقات المُقدَّم في الطلب غير صالح، ما يعني أن خادم واجهة برمجة التطبيقات لن يتمكّن من التحقّق من الحد الأقصى للحصة المحددة للتطبيق الذي يقدّم الطلب. استخدِم Google Developers Console للعثور على مفتاح واجهة برمجة التطبيقات أو للحصول على مفتاح.
lockedDomainCreationFailure	تم تلقّي رمز OAuth المميز في سلسلة طلب البحث، والتي تحظرها واجهة برمجة التطبيقات هذه بالنسبة إلى تنسيقات الاستجابة بخلاف JSON أو XML. جرِّب إرسال رمز OAuth المميز في عنوان التفويض بدلاً من ذلك إن أمكن.
notDownload	لا يمكن إرسال سوى طلبات تنزيل الوسائط إلى مسارات عناوين URL /download/*. يمكنك إعادة إرسال الطلب إلى المسار نفسه بدون البادئة /download.
notUpload	تعذّرت تلبية الطلب لأنه ليس طلب تحميل، ولا يمكن إرسال سوى طلبات التحميل إلى معرّفات الموارد المنتظمة (URI) الخاصة بـ /upload/*. يُرجى محاولة إعادة إرسال الطلب إلى المسار نفسه بدون البادئة /upload.
parseError	يتعذَّر على خادم واجهة برمجة التطبيقات تحليل نص الطلب.
required	لا يتضمن طلب البيانات من واجهة برمجة التطبيقات بعض المعلومات المطلوبة. قد تكون المعلومات المطلوبة هي إحدى المعلَمات أو مواقع الموارد.
tooManyParts	تعذَّرت تلبية الطلب متعدد الأجزاء لاحتوائه على أجزاء كثيرة.
unknownApi	تعذَّر التعرُّف على واجهة برمجة التطبيقات التي تم إرسال الطلب إليها.
unsupportedMediaProtocol	يستخدم العميل بروتوكول وسائط غير متوافق.
unsupportedOutputFormat	تحدّد قيمة المعلَمة alt تنسيقًا للمُخرجات غير متوافق مع هذه الخدمة. يمكنك التحقّق من قيمة معلَمة طلب alt.
wrongUrlForUpload	تعذَّرت تلبية الطلب مع أنه طلب تحميل، لأنه لم يتم إرساله إلى معرّف الموارد المنتظِم (URI) الصحيح. يجب إرسال طلبات التحميل إلى معرّفات الموارد المنتظِمة التي تتضمن البادئة /upload/*. يمكنك إعادة إرسال الطلب إلى المسار نفسه مع إضافة البادئة /upload.

UNAUTHORIZED (401)

رمز الخطأ	الوصف
unauthorized	غير مسموح للمستخدِم بإرسال الطلب.
authError	بيانات اعتماد التفويض المقدّمة للطلب غير صالحة. تحقّق من قيمة رأس طلب HTTP Authorization.
expired	انتهت صلاحية الجلسة. تحقّق من قيمة رأس طلب HTTP Authorization.
lockedDomainExpired	تعذَّرت تلبية الطلب لانتهاء صلاحية أحد النطاقات التي تم قفلها والذي كان نطاقًا صالحًا في السابق.
required	على المستخدم تسجيل الدخول لتقديم طلب البيانات من واجهة برمجة التطبيقات. تحقّق من قيمة رأس طلب HTTP Authorization.

PAYMENT_REQUIRED (402)

رمز الخطأ	الوصف
dailyLimitExceeded402	تم الوصول إلى حد الميزانية اليومية الذي حدّده مطوّر البرامج.
quotaExceeded402	تحتاج العملية المطلوبة إلى موارد أكثر مما تسمح به الحصة. يجب دفع مبلغ مالي لإتمام العملية.
user402	تقتضي العملية المطلوبة من المستخدِم المُصدَّق عليه دفع مبلغ معيّن.

FORBIDDEN (403)

رمز الخطأ	الوصف
forbidden	يحظر إجراء العملية المطلوبة ولا يمكن إتمامها.
accessNotConfigured	لم يتم ضبط مشروعك للوصول إلى واجهة برمجة التطبيقات هذه. يُرجى استخدام Google Developers Console لتفعيل واجهة برمجة التطبيقات الخاصة بمشروعك.
accessNotConfigured	تم حظر المشروع بسبب إساءة الاستخدام. راجِع http://support.google.com/code/go/developer_compliance.
accessNotConfigured	تم تحديد المشروع لحذفه.
accountDeleted	تم حذف حساب المستخدِم المرتبط ببيانات اعتماد التفويض الخاصة بالطلب. تحقّق من قيمة رأس طلب HTTP Authorization.
accountDisabled	تم إيقاف حساب المستخدِم المرتبط ببيانات اعتماد التفويض الخاصة بالطلب. تحقّق من قيمة رأس طلب HTTP Authorization.
accountUnverified	لم يتم إثبات ملكية عنوان البريد الإلكتروني للمستخدِم الذي أرسل الطلب. تحقّق من قيمة رأس طلب HTTP Authorization.
concurrentLimitExceeded	تعذَّرت تلبية الطلب نظرًا للوصول إلى الحد الأقصى المسموح به للاستخدام المتزامن.
dailyLimitExceeded	تم الوصول إلى الحد الأقصى للحصة اليومية المسموح بها على واجهة برمجة التطبيقات.
dailyLimitExceeded	تم الوصول إلى الحد الأقصى للحصة اليومية المسموح بها، وتم حظر المشروع بسبب إساءة الاستخدام. راجِع نموذج دعم امتثال Google APIs للمساعدة في حلّ المشكلة.
dailyLimitExceededUnreg	تعذّرت تلبية الطلب نظرًا للوصول إلى الحد الأقصى اليومي للاستخدام غير المُصدَّق عليه لواجهة برمجة التطبيقات. تتطلب مواصلة استخدام واجهة برمجة التطبيقات الحصول على اشتراك من خلال Google Developers Console.
downloadServiceForbidden	لا تتيح واجهة برمجة التطبيقات خدمة التنزيل.
insufficientAudience	يتعذَّر إتمام الطلب لهذا الجمهور.
insufficientAuthorizedParty	يتعذّر إتمام الطلب لهذا التطبيق.
insufficientPermissions	لا يمتلك المستخدِم المُصدَّق عليه أذونات كافية لتنفيذ هذا الطلب.
limitExceeded	يتعذَّر إتمام الطلب بسبب القيود المفروضة على الوصول أو معدّل الزحف.
lockedDomainForbidden	لا تتوافق واجهة برمجة التطبيقات هذه مع النطاقات التي تم قفلها.
quotaExceeded	تحتاج العملية المطلوبة إلى موارد أكثر مما تسمح به الحصة.
rateLimitExceeded	تم إرسال عدد كبير جدًا من الطلبات خلال فترة زمنية معيّنة.
rateLimitExceededUnreg	تم تجاوز الحدّ الأقصى لمعدّل الزحف وعليك تسجيل تطبيقك حتى تتمكّن من مواصلة استدعاء واجهة برمجة التطبيقات. يُرجى الاشتراك باستخدام Google Developers Console.
responseTooLarge	المورد المطلوب كبير جدًا بحيث يتعذّر عرضه.
servingLimitExceeded	سبقَ وتم الوصول إلى الحد الأقصى لإجمالي معدّل الزحف المحدّد لواجهة برمجة التطبيقات.
sslRequired	يلزم استخدام "طبقة المقابس الآمنة" لتنفيذ هذه العملية.
unknownAuth	لم يتعرّف خادم واجهة برمجة التطبيقات على نظام التفويض المستخدَم للطلب. تحقّق من قيمة رأس طلب HTTP Authorization.
userRateLimitExceeded	تعذّرت تلبية الطلب نظرًا للوصول إلى الحد الأقصى المسموح به لمعدّل الزحف لكل مستخدم.
userRateLimitExceededUnreg	تعذّرت تلبية الطلب بسبب بلوغ الحد الأقصى لمعدّل الزحف المسموح به لكل مستخدم، وعدم تحديد مطوّر برامج العميل في الطلب. يُرجى استخدام Google Developers Console (https://console.developers.google.com) لإنشاء مشروع لتطبيقك.
variableTermExpiredDailyExceeded	تعذّرت تلبية الطلب بسبب انتهاء صلاحية الحصة المتغيرة المدة والوصول إلى الحدّ الأقصى المسموح به يوميًا.
variableTermLimitExceeded	تعذَّرت تلبية الطلب نظرًا للوصول إلى الحد الأقصى المسموح به للحصة المتغيرة المدة.

NOT_FOUND (404)

رمز الخطأ	الوصف
notFound	لم يتم تنفيذ العملية المطلوبة لتعذُّر العثور على مورد مرتبط بالطلب.
notFound	تعذَّر العثور على مورد مرتبط بالطلب. إذا لم تكن قد استخدمت واجهة برمجة التطبيقات هذه خلال الأسبوعين الماضيين، يُرجى إعادة تفعيل تطبيق App Engine ومحاولة استدعاء الواجهة مرة أخرى.
unsupportedProtocol	البروتوكول المستخدَم في الطلب غير متوافق.

METHOD_NOT_ALLOWED (405)

رمز الخطأ	الوصف
httpMethodNotAllowed	طريقة HTTP المرتبطة بالطلب غير متوافقة.

CONFLICT (409)

رمز الخطأ	الوصف
conflict	يتعذَّر إتمام طلب البيانات من واجهة برمجة التطبيقات نظرًا لتعارض العملية المطلوبة مع أحد العناصر الحالية. على سبيل المثال، قد يحدث التعارض بسبب محاولة الطلب تكرار أحد العناصر، على الرغم من ارتباط العناصر المكررة عادةً بأخطاء أكثر تحديدًا.
duplicate	تعذَّر تنفيذ العملية المطلوبة نظرًا لمحاولة إنشاء مورد موجود سابقًا.

GONE (410)

رمز الخطأ	الوصف
deleted	تعذَّرت تلبية الطلب نظرًا لحذف المورد المرتبط به.

PRECONDITION_FAILED (412)

رمز الخطأ	الوصف
conditionNotMet	لم يتم استيفاء الشرط المحدّد في عنوان طلب HTTP الخاص بالسمة If-Match أو السمة If-None-Match. راجِع قسم ETag الخاص بمواصفات HTTP للحصول على مزيد من التفاصيل. تحقّق من قيمة رأس طلب HTTP If-Match.

REQUEST_ENTITY_TOO_LARGE (413)

رمز الخطأ	الوصف
backendRequestTooLarge	حجم الطلب كبير جدًا.
batchSizeTooLarge	يشتمل الطلب المجمّع على عناصر كثيرة جدًا.
uploadTooLarge	تعذَّرت تلبية الطلب لأن البيانات المرسَلة في الطلب كبيرة جدًا.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

رمز الخطأ	الوصف
requestedRangeNotSatisfiable	حدَّد الطلب نطاقًا تتعذَّر تلبيته.

EXPECTATION_FAILED (417)

رمز الخطأ	الوصف
expectationFailed	لا يلبي الخادم توقعات العميل.

PRECONDITION_REQUIRED (428)

رمز الخطأ	الوصف
preconditionRequired	يحتاج الطلب إلى شرط مسبق لم يتم توفيره. لنجاح هذا الطلب، يجب تقديم إما رأس If-Match أو If-None-Match مع الطلب.

TOO_MANY_REQUESTS (429)

رمز الخطأ	الوصف
rateLimitExceeded	تم إرسال عدد كبير جدًا من الطلبات خلال فترة زمنية محددة.

INTERNAL_SERVER_ERROR (500)

رمز الخطأ	الوصف
internalError	تعذَّرت تلبية الطلب بسبب خطأ داخلي.

NOT_IMPLEMENTED (501)

رمز الخطأ	الوصف
notImplemented	تعذَّر تنفيذ العملية المطلوبة.
unsupportedMethod	تعذَّرت تلبية الطلب لمحاولته تنفيذ طريقة أو عملية غير معروفة.

SERVICE_UNAVAILABLE (503)

رمز الخطأ	الوصف
backendError	حدث خطأ في الخلفية.
backendNotConnected	تعذَّرت تلبية الطلب لحدوث خطأ في الاتصال.
notReady	خادم واجهة برمجة التطبيقات ليس مستعدًا لقبول الطلبات.