حل الأخطاء

تعرض واجهة برمجة التطبيقات Google Drive مستويين من معلومات الخطأ:

  • رموز خطأ HTTP ورسائل العناوين.
  • عنصر JSON في نص الاستجابة مع تفاصيل إضافية يمكن أن تساعدك وتحدد كيفية التعامل مع الخطأ.

من المفترض أن ترصد تطبيقات Google Drive جميع الأخطاء التي قد تحدث وتعالجها. عند استخدام واجهة برمجة تطبيقات REST. يقدّم هذا الدليل إرشادات حول كيفية حلّ المشكلة. أخطاء محددة في Drive API.

ملخّص رمز حالة HTTP

رمز الخطأ الوصف
200 - OK تم الطلب بنجاح (هذه هي الاستجابة العادية لطلبات HTTP الناجحة).
400 - Bad Request يتعذَّر تنفيذ الطلب بسبب خطأ من جانب العميل.
401 - Unauthorized يحتوي الطلب على بيانات اعتماد غير صالحة.
403 - Forbidden تم استلام الطلب وفهمه، ولكن المستخدم لا يملك الإذن لتنفيذ الطلب.
404 - Not Found تعذَّر العثور على الصفحة المطلوبة.
429 - Too Many Requests تم إرسال عدد كبير جدًا من الطلبات إلى واجهة برمجة التطبيقات.
500, 502, 503, 504 - Server Errors يحدث خطأ غير متوقّع أثناء معالجة الطلب.

أخطاء 400

تعني هذه الأخطاء أن الطلب لم يكن مقبولاً، وغالبًا ما يكون بسبب المطلوبة.

badRequest

يمكن أن يحدث هذا الخطأ نتيجة أي مشكلة من المشكلات التالية في التعليمات البرمجية:

  • لم يتم توفير حقل مطلوب أو معلمة مطلوبة.
  • القيمة المقدمة أو مجموعة الحقول المتوفرة غير صالحة.
  • لقد حاولت إضافة عنصر رئيسي مكرّر إلى ملف على Drive.
  • لقد حاولت إضافة عنصر رئيسي من شأنه إنشاء دورة في الرسم البياني للدليل.

يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "code": 400,
    "errors": [
      {
        "domain": "global",
        "location": "orderBy",
        "locationType": "parameter",
        "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order.",
        "reason": "badRequest"
      }
    ],
    "message": "Sorting is not supported for queries with fullText terms. Results are always in descending relevance order."
  }
}

لإصلاح هذا الخطأ، تحقَّق من حقل message وعدِّل الرمز وفقًا لذلك.

invalidSharingRequest

يحدث هذا الخطأ لعدة أسباب. لتحديد السبب، قم بتقييم الحقل reason لملف JSON الذي تم عرضه. يحدث هذا الخطأ في أغلب الأحيان للأسباب التالية:

  • نجحت المشاركة، ولكن لم يتم تسليم إشعار البريد الإلكتروني بشكل صحيح.
  • غير مسموح بتغيير قائمة التحكم بالوصول (ACL) لهذا المستخدم.

ويشير الحقل message إلى الخطأ الفعلي.

نجحت المشاركة، ولكن لم يتم تسليم إشعار البريد الإلكتروني بشكل صحيح.

يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"Sorry, the items were successfully shared but emails could not be sent to email@domain.com.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

لإصلاح هذا الخطأ، أخبِر المستخدم (المُشارِك) بأنّه تعذَّر عليه المشاركة بسبب عدم تمكُّنه من المشاركة. تعذّر إرسال إشعار البريد الإلكتروني إلى عنوان البريد الإلكتروني الوجهة. تشير رسالة الأشكال البيانية التأكد من امتلاكه لعنوان البريد الإلكتروني الصحيح وأنه يمكن استلام رسالة إلكترونية.

غير مسموح بتغيير ACL لهذا المستخدم

يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "invalidSharingRequest",
        "message": "Bad Request. User message: \"ACL change not allowed.\""
      }
    ],
    "code": 400,
    "message": "Bad Request"
  }
}

لإصلاح هذا الخطأ، تحقق من علامة التبويب المشاركة الإعدادات لنطاق Google Workspace الذي ينتمي إليه الملف. قد تتضمن الإعدادات حظر المشاركة خارج النطاق أو مشاركة مساحة تخزين سحابي مشتركة المسموح بها.

أخطاء 401

تعني هذه الأخطاء أن الطلب لا يحتوي على رمز دخول صالح.

authError

يحدث هذا الخطأ عندما تنتهي صلاحية رمز الدخول الذي تستخدمه أو غير صالح. وقد يرجع السبب في هذا الخطأ أيضًا إلى عدم توفر تفويض والنطاقات المطلوبة. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "authError",
        "message": "Invalid Credentials",
        "locationType": "header",
        "location": "Authorization",
      }
    ],
    "code": 401,
    "message": "Invalid Credentials"
  }
}

لإصلاح هذا الخطأ، عليك إعادة تحميل رمز الدخول باستخدام الرمز المميّز الطويل الأمد لإعادة التحميل. وإذا تعذَّر ذلك، يمكنك توجيه المستخدم من خلال مسار OAuth، كما هو موضح في اختيار نطاقات واجهة برمجة تطبيقات Google Drive

أخطاء 403

تعني هذه الأخطاء أنه تم تجاوز الحد الأقصى للاستخدام أو لم يحصل المستخدم على بالامتيازات الصحيحة. ولتحديد السبب، قيِّم حقل reason في JSON الذي تم إرجاعه.

للحصول على معلومات حول حدود واجهة برمجة تطبيقات Drive، يُرجى الرجوع إلى حدود الاستخدام. للحصول على معلومات عن مجلد Drive يمكنك الرجوع إلى حدود الملفات والمجلدات.

activeItemCreationLimitExceeded

يحدث خطأ activeItemCreationLimitExceeded عندما يتجاوز الحدّ الأقصى لعدد الأرقام تم تجاوز الحد الأقصى من العناصر التي تم إنشاؤها لكل حساب. يمكن أن يحصل كل مستخدم على ما يصل إلى 500 مستخدم مليون عنصر تم إنشاؤه بواسطة الحساب. لمزيد من المعلومات، يُرجى الاطّلاع على عنصر المستخدم الحد الأقصى.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "activeItemCreationLimitExceeded",
    "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
   }
  ],
  "code": 403,
  "message": "This account has exceeded the creation limit of 500 million items. To create more items, permanently delete some items."
 }
}

لإصلاح هذا الخطأ:

  1. إبلاغ المستخدم بأنّ تطبيق Drive يمنع إنشاء الحسابات أكثر من 500 مليون عنصر.

  2. إذا كان على المستخدم إنشاء عناصر في الحساب نفسه، يُرجى إرشاده إلى ما يلي: حذف بعض العناصر نهائيًا. بخلاف ذلك، يمكنه استخدام حساب مختلف التي تفي بالفعل بالمطلب.

appNotAuthorizedToFile

يحدث هذا الخطأ عندما لا يكون تطبيقك مدرجًا في قائمة التحكم بالوصول (ACL) للملف. هذا الخطأ يمنع المستخدم من فتح الملف باستخدام تطبيقك. نموذج JSON التالي هو تمثيل لهذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "appNotAuthorizedToFile",
        "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user has not granted the app {appId} {verb} access to the file {fileId}."
  }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

  • فتح أداة اختيار Google Drive وتطلب من المستخدم فتح الملف.
  • توجيه المستخدم لفتح الملف باستخدام قائمة سياق فتح باستخدام في Drive واجهة المستخدم الخاصة بتطبيقك
  • استخدِم الطريقة files.get من أجل تحقق من الحقل isAppAuthorized في files للتحقق من أن أنشأ التطبيق أو فتح الملف.

cannotModifyInheritedTeamDrivePermission

يحدث هذا الخطأ عندما يحاول مستخدم تعديل الأذونات المكتسَبة لحساب عنصر في مساحة تخزين سحابي مشتركة. لا يمكن إزالة الأذونات المكتسَبة من عنصر واحد. في مساحة تخزين سحابي مشتركة. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "cannotModifyInheritedTeamDrivePermission",
        "message": "Cannot update or delete an inherited permission on a shared drive item."
      }
    ],
    "code": 403,
    "message": "Cannot update or delete an inherited permission on a shared drive item."
  }
}

لإصلاح هذا الخطأ، يجب على المستخدم تعديل الأذونات في الوضع المباشر أو غير المباشر العنصر الأصلي الذي تم اكتساب هذه العناصر منه. لمزيد من المعلومات، يُرجى مراجعة الإذن الانتشار. يمكنك أيضًا استرداد permissions.permissionDetails لمعرفة ما إذا كانت الأذونات على عنصر مساحة التخزين السحابي المشتركة هذا مكتسَبة أو تطبيقها مباشرةً.

dailyLimitExceeded

يحدث هذا الخطأ عندما يتم الوصول إلى الحد الأقصى المسموح به لواجهة برمجة التطبيقات لمشروعك. ما يلي: يمثّل نموذج JSON هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "dailyLimitExceeded",
        "message": "Daily Limit Exceeded"
      }
    ],
    "code": 403,
    "message": "Daily Limit Exceeded"
  }
}

يظهر هذا الخطأ عندما يضع مالك التطبيق حدًا أقصى للحصة استخدام مورد معين. لإصلاح هذا الخطأ، عليك إزالة أي حدود استخدام قصوى "طلبات البحث في اليوم" الحصة.

domainPolicy

يحدث هذا الخطأ عندما لا تسمح سياسة نطاق المستخدم بالوصول إلى قيادة السيارة بجانب تطبيقك. نموذج JSON التالي هو تمثيل بهذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "domainPolicy",
        "message": "The domain administrators have disabled Drive apps."
      }
    ],
    "code": 403,
    "message": "The domain administrators have disabled Drive apps."
  }
}

لإصلاح هذا الخطأ:

  1. إبلاغ المستخدم بأنّ النطاق لا يسمح لتطبيقك بالوصول إلى الملفات في Google Drive.
  2. توجيه المستخدم للاتصال بمشرف النطاق لطلب الوصول إلى تطبيقك.

fileOwnerNotMemberOfTeamDrive

يحدث هذا الخطأ عند محاولة نقل ملف إلى مساحة تخزين سحابي مشتركة مالك الملف ليس عضوًا. يمثّل نموذج JSON التالي هذا خطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileOwnerNotMemberOfTeamDrive",
        "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
      }
    ],
    "code": 403,
    "message": "Cannot move a file into a shared drive as a writer when the owner of the file is not a member of that shared drive."
  }
}

لإصلاح هذا الخطأ:

  1. إضافة العضو إلى مساحة التخزين السحابي المشتركة مع role=owner. لمزيد من المعلومات يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين السحابي.

  2. أضِف الملف إلى مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، راجع إنشاء تعبئة المجلدات.

fileWriterTeamDriveMoveInDisabled

يحدث هذا الخطأ عندما لا يسمح مشرف النطاق للمستخدمين الذين لديهم role=writer لنقل العناصر إلى "مساحة التخزين السحابي المشتركة". يحاول المستخدم نقل يحتوي عنصر على أذونات أقل من المسموح به في مساحة التخزين السحابي المشتركة الوجهة. تشير رسالة الأشكال البيانية يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileWriterTeamDriveMoveInDisabled",
        "message": "The domain administrator has not allowed writers to move items into a shared drive."
      }
    ],
    "code": 403,
    "message": "The domain administrator has not allowed writers to move items into a shared drive."
  }
}

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

insufficientFilePermissions

يحدث هذا الخطأ عندما لا يمتلك المستخدم إذنًا بالتعديل في أحد الملفات، يحاول التطبيق تعديل الملف. نموذج JSON التالي هو تمثيل لهذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "insufficientFilePermissions",
        "message": "The user does not have sufficient permissions for file {fileId}."
      }
    ],
    "code": 403,
    "message": "The user does not have sufficient permissions for file {fileId}."
  }
}

لإصلاح هذا الخطأ، يمكنك إرشاد المستخدم إلى التواصل مع مالك الملف وطلبه. الإذن بتعديل المحتوى. يمكنك أيضًا التحقّق من مستويات وصول المستخدمين في البيانات الوصفية التي تم استردادها من خلال طريقة files.get وعرض واجهة المستخدم للقراءة فقط عند عدم توفر الأذونات.

myDriveHierarchyDepthLimitExceeded

يحدث الخطأ myDriveHierarchyDepthLimitExceeded عندما يقع الحدّ الأقصى تم تجاوز عدد مستويات المجلدات المتداخلة. خاص بي للمستخدم لا يمكن أن يحتوي Drive على أكثر من 100 مستوى من المجلدات المُدمَجة. بالنسبة للحصول على مزيد من المعلومات، يُرجى الاطّلاع على عمق المجلد الحد الأقصى.

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "myDriveHierarchyDepthLimitExceeded",
    "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/drive/api/guides/handle-errors#nested-folder-levels."
   }
  ],
  "code": 403,
  "message": "Your My Drive can't contain more than 100 levels of folders. For details, see https://developers.google.com/drive/api/guides/handle-errors#nested-folder-levels."
 }
}

لإصلاح هذا الخطأ:

  1. إبلاغ المستخدم بأن تطبيق Drive يمنع وضع مجلدات تزيد مدتها عن في عمق 100 مستوى.
  2. إذا كان على المستخدم إنشاء مجلد متداخل آخر، اطلب منه إعادة تنظيمه أن يكون عمق المجلد الرئيسي المقصود أقل من 100 مستوى أو أن يستخدم مجلد رئيسي مختلف يلبي المتطلبات بالفعل.

numChildrenInNonRootLimitExceeded

يحدث هذا الخطأ عندما يكون الحد الأقصى لعدد العناصر الثانوية في المجلد (المجلدات والاختصارات) تم تجاوزها. هناك حد أقصى لعدد العناصر يبلغ 500000 المجلدات والملفات والاختصارات في المجلد مباشرةً. العناصر المدمجة في المجلدات الفرعية لا يتم احتسابها ضمن هذا الحد البالغ 500,000 سلعة. لمزيد من المعلومات حول حدود مجلدات Drive، راجِع الحدود القصوى المسموح بها للمجلدات في Google Drive

يمثّل نموذج JSON التالي هذا الخطأ:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "numChildrenInNonRootLimitExceeded",
    "message": "The limit for this folder's number of children (files and folders) has been exceeded."
   }
  ],
  "code": 403,
  "message": "The limit for this folder's number of children (files and folders) has been exceeded."
 }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

  • إبلاغ المستخدم بأن تطبيق Drive يمنع المجلدات التي تحتوي على أكثر من 500,000 عنصر.
  • إذا كان على المستخدم إضافة المزيد من العناصر إلى المجلد الكامل، اطلب منه إجراء ما يلي: أعِد تنظيم المجلد ليحتوي على أقل من 500,000 عنصر أو استخدم عنوانًا مشابهًا يحتوي على عناصر أقل من قبل.

rateLimitExceeded

يحدث هذا الخطأ عند الوصول إلى الحد الأقصى لمعدل المشروع. هذا الحد الأقصى تختلف تبعًا لنوع الطلب. نموذج JSON التالي هو تمثيل لهذا الخطأ:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "message": "Rate Limit Exceeded",
    "reason": "rateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

sharingRateLimitExceeded

يحدث هذا الخطأ عندما يصل المستخدم إلى الحد الأقصى المسموح به للمشاركة ويتم ربطه غالبًا. بحد أقصى للبريد الإلكتروني. يمثّل نموذج JSON التالي هذا خطأ:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "Rate limit exceeded. User message: \"These item(s) could not be shared because a rate limit was exceeded: filename",
    "reason": "sharingRateLimitExceeded",
   }
  ],
  "code": 403,
  "message": "Rate Limit Exceeded"
 }
}

لإصلاح هذا الخطأ:

  1. لا ترسل رسائل إلكترونية عند مشاركة كميات كبيرة من الملفات.
  2. إذا كان أحد المستخدمين يرسل العديد من الطلبات نيابة عن العديد من مستخدمي حساب Google Workspace، ننصحك باستخدام حساب خدمة على مستوى النطاق. التفويض باستخدام quotaUser .

storageQuotaExceeded

يحدث هذا الخطأ عندما يصل المستخدم إلى الحدّ الأقصى المسموح به لمساحة التخزين. ما يلي: يمثّل نموذج JSON هذا الخطأ:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "message": "The user's Drive storage quota has been exceeded.",
    "reason": "storageQuotaExceeded",
   }
  ],
  "code": 403,
  "message": "The user's Drive storage quota has been exceeded."
 }
}

لإصلاح هذا الخطأ:

  1. راجِع حدود مساحة التخزين في حسابك على Drive. لمزيد من المعلومات، المعلومات، يُرجى الرجوع إلى مساحة التخزين في Google Workspace والتحميل .

  2. إدارة الملفات في Google Drive مساحة التخزين.

  3. شراء المزيد من منتجات Google مساحة التخزين.

teamDriveFileLimitExceeded

يحدث هذا الخطأ عندما يحاول المستخدم تجاوز الحدّ الأقصى المسموح به لعدد السلع في مساحة التخزين السحابي المشتركة. يبلغ الحد الأقصى المسموح به لعدد العناصر في كل مجلد في مساحة التخزين السحابي المشتركة للمستخدم 500,000 عنصر بما في ذلك الملفات والمجلدات والاختصارات. ويستند هذا الحد إلى عدد العناصر، وليس مساحة التخزين المستخدَمة. لمزيد من المعلومات، يُرجى الاطّلاع على الحدود القصوى المسموح بها على مساحات التخزين السحابي المشتركة في Google Drive

يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveFileLimitExceeded",
        "message": "The file limit for this shared drive has been exceeded."
      }
    ],
    "code": 403,
    "message": "The file limit for this shared drive has been exceeded."
  }
}

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

teamDriveHierarchyTooDeep

يحدث خطأ teamDriveHierarchyTooDeep عندما يقع الحد الأقصى لعدد تم تجاوز مستويات المجلدات المدمجة في مساحة التخزين السحابي المشتركة. لا يمكن لمساحة التخزين السحابي المشتركة لمستخدم تحتوي على أكثر من 100 مستوى من المجلدات المتداخلة. لمزيد من المعلومات، يُرجى مراجعة الحد الأقصى لعمق المجلد:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "teamDriveHierarchyTooDeep",
    "message": "The shared drive hierarchy depth will exceed the limit."
   }
  ],
  "code": 403,
  "message": "The shared drive hierarchy depth will exceed the limit."
 }
}

لإصلاح هذا الخطأ:

  1. إبلاغ المستخدم بأن مساحات التخزين السحابي المشتركة تمنع وضع مجلدات تزيد عن في عمق 100 مستوى.
  2. إذا كان على المستخدم إنشاء مجلد متداخل آخر، اطلب منه إعادة تنظيمه أن يكون عمق المجلد الرئيسي المقصود أقل من 100 مستوى أو أن يستخدم مجلد رئيسي مختلف يلبي المتطلبات بالفعل.

teamDriveMembershipRequired

يحدث هذا الخطأ عندما يحاول مستخدم الوصول إلى مساحة تخزين سحابي مشتركة غير عضو. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDriveMembershipRequired",
        "message": "The attempted action requires shared drive membership."
      }
    ],
    "code": 403,
    "message": "The attempted action requires shared drive membership."
  }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

  1. اطلب من مدير مساحة التخزين السحابي المشتركة إضافتك باستخدام الملفات الأذونات المتعلقة بالإجراء الذي يجب تنفيذه.

  2. راجِع أدوار الأذونات لمعرفة من يمكنه الوصول إلى البيانات وإدارتها مساحات التخزين السحابي المشتركة. يمكن أيضًا الاطّلاع على معلومات إضافية حول مستويات الوصول. في إنشاء ملف شخصي مشترك Google Drive.

teamDrivesFolderMoveInNotSupported

يحدث هذا الخطأ عندما يحاول أحد المستخدمين نقل مجلد من Drive إلى مساحة تخزين سحابي مشتركة نموذج JSON التالي هو تمثيل لهذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesFolderMoveInNotSupported",
        "message": "Moving folders into shared drives is not supported."
      }
    ],
    "code": 403,
    "message": "Moving folders into shared drives is not supported."
  }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

  • يمكنك نقل العناصر الفردية من المجلد إلى مساحة تخزين سحابي مشتركة باستخدام واجهة برمجة تطبيقات Drive. اضبط المَعلمة supportsAllDrives=true للإشارة إلى دعم لكل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

  • إذا كان عليك نقل المجلد إلى مساحة تخزين سحابي مشتركة، استخدِم واجهة مستخدم Drive. لمزيد من المعلومات، راجِع نقل المجلدات إلى المجلدات المشتركة. Drive بصفتك مشرفًا.

teamDrivesParentLimit

يحدث هذا الخطأ عندما يحاول مستخدم إضافة أكثر من عنصر رئيسي إلى عنصر في مساحة تخزين سحابي مشتركة. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "teamDrivesParentLimit",
        "message": "A shared drive item must have exactly one parent."
      }
    ],
    "code": 403,
    "message": "A shared drive item must have exactly one parent."
  }
}

لإصلاح هذا الخطأ، استخدِم اختصارات Drive لإضافة روابط متعددة إلى الملف. وعلى الرغم من أن الاختصار لا يمكن أن يكون إلا أحد الوالدين، إلا أنه يمكن إنشاء نسخ إلى المواقع الإضافية. لمزيد من المعلومات، راجع إنشاء اختصار إلى ملف على Drive.

UrlLeaseLimitExceeded

يحدث هذا الخطأ عند محاولة حفظ بيانات ألعاب Google Play من خلال التطبيق. يمثّل نموذج JSON التالي هذا الخطأ:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "UrlLeaseLimitExceeded",
    "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
   }
  ],
  "code": 403,
  "message": "Too many pending uploads for this snapshot. Please finish or cancel some before creating more."
 }
}

لإصلاح هذا الخطأ، أكمِل أي عمليات تحميل للقطة أو ألغِها قبل إنشائها. أخرى.

userRateLimitExceeded

يحدث هذا الخطأ عند الوصول إلى الحدّ الأقصى المسموح به لكل مستخدم. قد يكون هذا حد من وحدة تحكم Google Cloud أو حد من Drive الخلفية. يمثّل نموذج JSON التالي هذا الخطأ:

{
 "error": {
  "errors": [
   {
    "domain": "usageLimits",
    "reason": "userRateLimitExceeded",
    "message": "User Rate Limit Exceeded"
   }
  ],
  "code": 403,
  "message": "User Rate Limit Exceeded"
 }
}

لإصلاح هذا الخطأ، يمكنك تجربة أيّ مما يلي:

للحصول على معلومات حول حدود واجهة برمجة تطبيقات Drive، يُرجى الرجوع إلى حدود الاستخدام.

أخطاء 404

تعني هذه الأخطاء أنه لا يمكن الوصول إلى المورد المطلوب أو أنه غير موجود.

notFound

يحدث هذا الخطأ عندما لا يملك المستخدم إذن الوصول لقراءة ملف أو لا. غير موجود. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "notFound",
        "message": "File not found {fileId}"
      }
    ],
    "code": 404,
    "message": "File not found: {fileId}"
  }
}

لإصلاح هذا الخطأ:

  1. إذا كان الملف موجودًا في مساحة تخزين سحابي مشتركة وكنت تستخدم ملف files.get، تأكَّد من تم ضبط معلَمة طلب البحث supportsAllDrives على true.
  2. إبلاغ المستخدم بأنّه لا يملك الإذن بقراءة الملف أو الملف غير موجود.
  3. وجِّه المستخدم للاتصال بمالك الملف واطلب منه إذنًا الملف.

أخطاء 429

تعني هذه الأخطاء أنّه تم إرسال عدد كبير جدًا من الطلبات إلى واجهة برمجة التطبيقات بسرعة كبيرة جدًا.

rateLimitExceeded

يحدث هذا الخطأ عندما يرسل المستخدم عددًا كبيرًا جدًا من الطلبات في مقدار الوقت. يمثّل نموذج JSON التالي هذا الخطأ:

{
  "error": {
    "errors": [
      {
        "domain": "usageLimits",
        "reason": "rateLimitExceeded",
        "message": "Rate Limit Exceeded"
      }
    ],
    "code": 429,
    "message": "Rate Limit Exceeded"s
  }
}

لإصلاح هذا الخطأ، استخدم دالة الأس التراجع لإعادة محاولة الطلب.

أخطاء 500 أو 502 أو 503 أو 504

تحدث هذه الأخطاء عندما ينشأ خطأ غير متوقع في الخادم أثناء معالجة طلبك. يمكن أن تتسبب مشاكل مختلفة في حدوث هذه الأخطاء، بما في ذلك توقيت الطلب. التداخل مع طلب آخر أو طلب تنفيذ إجراء غير متوافق، مثل محاولة تحديث الأذونات لصفحة واحدة في مواقع Google بدلاً من للموقع بأكمله.

في ما يلي قائمة بأخطاء 5xx:

  • 500 خطأ في الخلفية
  • 502 مدخل غير صالح
  • 503 الخدمة غير متوفرة
  • 504 انتهاء مهلة المدخل

لإصلاح هذا الخطأ، استخدم دالة الأس التراجع لإعادة محاولة الطلب.