الردود العادية على الأخطاء

يوضح هذا المستند بعض رموز الأخطاء والرسائل التي تعرضها أداة 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 تعذَّرت تلبية الطلب لأنه ليس طلب تحميل، ولا يمكن إرسال سوى طلبات التحميل إلى معرّفات الموارد المنتظِمة /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 Play Console (https://console.develop ers.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 خادم واجهة برمجة التطبيقات ليس مستعدًا لقبول الطلبات.