गड़बड़ियां ठीक करना

Google Drive API, गड़बड़ी की जानकारी के दो लेवल दिखाता है:

  • एचटीटीपी गड़बड़ी कोड और हेडर मैसेज.
  • रिस्पॉन्स बॉडी में मौजूद JSON ऑब्जेक्ट, जिसमें ज़्यादा जानकारी होती है. इससे आपको गड़बड़ी को मैनेज करने का तरीका तय करने में मदद मिलती है.

Google Drive के ऐप्लिकेशन को REST API का इस्तेमाल करते समय आने वाली सभी गड़बड़ियों को पकड़ना और उन्हें हैंडल करना चाहिए. इस गाइड में, Drive API की खास गड़बड़ियों को ठीक करने के बारे में निर्देश दिए गए हैं.

एचटीटीपी स्टेटस कोड की खास जानकारी

गड़बड़ी का कोड ब्यौरा
200 - OK अनुरोध पूरा हुआ (यह एचटीटीपी अनुरोधों के लिए स्टैंडर्ड रिस्पॉन्स है).
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

यह गड़बड़ी कई वजहों से होती है. इसकी वजह जानने के लिए, रिटर्न किए गए JSON के reason फ़ील्ड का आकलन करें. यह गड़बड़ी आम तौर पर इन वजहों से होती है:

  • शेयर करने की प्रोसेस पूरी हो गई, लेकिन सूचना वाला ईमेल सही तरीके से डिलीवर नहीं हुआ.
  • इस उपयोगकर्ता के लिए, ऐक्सेस कंट्रोल सूची (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"
  }
}

इस गड़बड़ी को ठीक करने के लिए, उपयोगकर्ता (शेयर करने वाले) को बताएं कि वह शेयर नहीं कर सका, क्योंकि सूचना वाला ईमेल, डेस्टिनेशन ईमेल पते पर नहीं भेजा जा सका. उपयोगकर्ता को यह पक्का करना चाहिए कि उसके पास सही ईमेल पता है और उसे ईमेल मिल सकता है.

इस उपयोगकर्ता के लिए, एसीएल में बदलाव करने की अनुमति नहीं है

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 API के दायरे चुनना में बताया गया है.

fileNotDownloadable

यह गड़बड़ी तब होती है, जब Google Workspace दस्तावेज़ में alt=media यूआरएल पैरामीटर के साथ revisions.get तरीके का इस्तेमाल करने की कोशिश की जाती है. इस गड़बड़ी को JSON के इस उदाहरण से समझा जा सकता है:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "fileNotDownloadable",
        "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
      }
    ],
    "code": 403,
    "message": "Only files with binary content can be downloaded. Use Export with Docs Editors files."
  }
}

इस गड़बड़ी को ठीक करने के लिए, इनमें से कोई एक तरीका आज़माएं:

  • अगर आपको किसी खास बदलाव का मेटाडेटा देखना है, जैसे कि mimetype के लिए, तो alt=media यूआरएल पैरामीटर हटाएं.
  • Google Workspace दस्तावेज़ का बाइट कॉन्टेंट एक्सपोर्ट करने के लिए, files.export तरीके का इस्तेमाल करें. ज़्यादा जानकारी के लिए, Google Workspace दस्तावेज़ का कॉन्टेंट एक्सपोर्ट करना लेख पढ़ें.

403 कोड वाली गड़बड़ियां

इन गड़बड़ियों का मतलब है कि इस्तेमाल की सीमा पार हो गई है या उपयोगकर्ता के पास सही अनुमतियां नहीं हैं. इसकी वजह जानने के लिए, लौटाए गए JSON के reason फ़ील्ड की जांच करें.

Drive API की सीमाओं के बारे में जानने के लिए, इस्तेमाल की सीमाएं लेख पढ़ें. 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, खातों को 50 करोड़ से ज़्यादा आइटम बनाने से रोकता है.

  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 तरीके का इस्तेमाल करके, files संसाधन पर isAppAuthorized फ़ील्ड की जांच करें. इससे यह पुष्टि की जा सकेगी कि आपके ऐप्लिकेशन ने फ़ाइल बनाई है या उसे खोला है.

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

यह गड़बड़ी तब होती है, जब उपयोगकर्ता के डोमेन की नीति के मुताबिक, आपके ऐप्लिकेशन को Drive को ऐक्सेस करने की अनुमति नहीं होती. यहां दिया गया 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. उपयोगकर्ता को बताएं कि डोमेन आपके ऐप्लिकेशन को 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 गड़बड़ी दिखती है. उपयोगकर्ता की 'मेरी ड्राइव' में नेस्ट किए हुए फ़ोल्डर के 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

यह गड़बड़ी तब होती है, जब किसी फ़ोल्डर में मौजूद चाइल्ड आइटम (फ़ोल्डर, फ़ाइलें, और शॉर्टकट) की संख्या तय सीमा से ज़्यादा हो जाती है. किसी फ़ोल्डर में, फ़ोल्डर, फ़ाइलों, और शॉर्टकट की संख्या 5,00,000 से ज़्यादा नहीं हो सकती. सब-फ़ोल्डर में नेस्ट किए गए आइटम इस 5,00,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 में 5,00,000 से ज़्यादा आइटम वाले फ़ोल्डर नहीं बनाए जा सकते.
  • अगर उपयोगकर्ता को पूरे फ़ोल्डर में ज़्यादा आइटम जोड़ने हैं, तो उसे फ़ोल्डर को फिर से व्यवस्थित करने के लिए कहें, ताकि उसमें 5,00,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

यह गड़बड़ी तब होती है, जब कोई उपयोगकर्ता शेयर की गई ड्राइव में आइटम की तय सीमा से ज़्यादा आइटम जोड़ने की कोशिश करता है. उपयोगकर्ता की शेयर की गई ड्राइव के हर फ़ोल्डर में 5,00,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. शेयर की गई ड्राइव को कौन ऐक्सेस और मैनेज कर सकता है, यह जानने के लिए Drive की भूमिकाओं और अनुमतियों की समीक्षा करें. ऐक्सेस लेवल के बारे में ज़्यादा जानकारी, शेयर की गई ड्राइव बनाएं पर भी मिल सकती है.

teamDrivesFolderMoveInNotSupported

यह गड़बड़ी तब होती है, जब कोई उपयोगकर्ता किसी फ़ोल्डर को 'मेरी ड्राइव' से 'शेयर की गई ड्राइव' में ले जाने की कोशिश करता है. नीचे दिया गया 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 API का इस्तेमाल करके, फ़ोल्डर में मौजूद अलग-अलग आइटम को शेयर की गई ड्राइव में ले जाएं. 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करने की जानकारी देने के लिए, supportsAllDrives=true पैरामीटर सेट करें.

  • अगर आपको फ़ोल्डर को शेयर की गई ड्राइव में ले जाना है, तो 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 Console की ओर से तय की गई सीमा हो सकती है या Drive के बैकएंड की ओर से तय की गई सीमा हो सकती है. इस गड़बड़ी को JSON के इस सैंपल में दिखाया गया है:

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

इस गड़बड़ी को ठीक करने के लिए, इनमें से किसी एक तरीके को आज़माएं:

Drive API की सीमाओं के बारे में जानने के लिए, इस्तेमाल की सीमाएं लेख पढ़ें.

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 Sites में किसी एक पेज की अनुमतियां अपडेट करने की कोशिश करना.

5xx कोड वाली गड़बड़ियों की सूची यहां दी गई है:

  • 500 बैकएंड गड़बड़ी
  • 502 खराब गेटवे
  • 503 सेवा उपलब्ध नहीं है
  • 504 गेटवे का टाइम आउट

इस गड़बड़ी को ठीक करने के लिए, अनुरोध को फिर से भेजने के लिए एक्सपोनेंशियल बैकऑफ़ का इस्तेमाल करें.