يوضح هذا المستند بعض رموز الأخطاء والرسائل التي تعرضها أداة 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]"
}
}
الأخطاء
- MOVED_PERMANENTLY (301)
- SEE_OTHER (303)
- NOT_MODIFIED (304)
- TEMPORARY_REDIRECT (307)
- BAD_REQUEST (400)
- UNAUTHORIZED (401)
- PAYMENT_REQUIRED (402)
- FORBIDDEN (403)
- NOT_FOUND (404)
- METHOD_NOT_ALLOWED (405)
- CONFLICT (409)
- GONE (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- TOO_MANY_REQUESTS (429)
- INTERNAL_SERVER_ERROR (500)
- NOT_IMPLEMENTED (501)
- 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 تنسيقًا غير معروف للمُخرجات. |
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 |
خادم واجهة برمجة التطبيقات ليس مستعدًا لقبول الطلبات. |