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

يوضح هذا المستند بعض رموز الأخطاء والرسائل التي تعرضها أداة 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 خادم واجهة برمجة التطبيقات ليس مستعدًا لقبول الطلبات.