أخطاء واجهة برمجة التطبيقات للفهرسة

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

الأخطاء الخاصة بواجهة برمجة التطبيقات للفهرسة

في جميع الحالات المذكورة أدناه، تم رفض الطلب ولم يزحف Google إلى عنوان URL. وينطبق ذلك أيضًا على رسائل الأخطاء الأساسية.

BAD_REQUEST (400)

رسالة الخطأ الوصف
Missing attribute. 'url' attribute is required. لم يحدّد المستخدِم عنوان URL في طلبه.
Invalid attribute. 'url' is not in standard URL format حدّد المستخدِم عنوان URL يختلف تنسيقه عن عنوان URL المعتاد، مثل "abcd".
Unknown type. 'type' attribute is required and must be 'URL_REMOVED' or 'URL_UPDATED'. لم يحدّد المستخدِم نوع الإشعار.
Invalid value at 'url_notification.type' (TYPE_ENUM) حدَّد المستخدِم نوع إشعار يختلف عن URL_REMOVED أو URL_UPDATED.

FORBIDDEN (403)

رسالة الخطأ الوصف
Permission denied. Failed to verify the URL ownership. لم يستكمل المستخدِم عملية "إثبات الملكية" أو أنه يحاول تعديل عنوان URL لا يمتلكه.

TOO_MANY_REQUESTS (429)

رسالة الخطأ الوصف
Insufficient tokens for quota 'indexing.googleapis.com/default_requests' يتجاوز المستخدِم حصته في واجهة برمجة التطبيقات للفهرسة.