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

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 फ़ील्ड देखें और अपने कोड में ज़रूरी बदलाव करें.

illegalKeepForeverModification

यह गड़बड़ी तब होती है, जब "हमेशा के लिए सेव रखें" के तौर पर मार्क किए गए किसी ब्लॉब फ़ाइल के वर्शन को false पर सेट करने की कोशिश की जाती है. इस गड़बड़ी को दिखाने वाला JSON का उदाहरण यहां दिया गया है:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "illegalKeepForeverModification",
    "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
   }
  ],
  "code": 400,
  "message": "Bad Request. Cannot update a revision to false that is marked as keepForever."
 }
}

इस गड़बड़ी को ठीक करने के लिए, "हमेशा के लिए सेव रखें" सेटिंग हटाने के लिए, किसी blob फ़ाइल के वर्शन को हमेशा के लिए मिटाएं.

invalidSharingRequest

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

  • शेयर करने की प्रोसेस पूरी हो गई है, लेकिन सूचना देने वाला ईमेल सही तरीके से डिलीवर नहीं हुआ.
  • इस उपयोगकर्ता को ऐक्सेस कंट्रोल लिस्ट (एसीएल) में बदलाव करने की अनुमति नहीं है.

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 दस्तावेज़ पर revisions.get यूआरएल पैरामीटर के साथ revisions.get तरीके का इस्तेमाल करने की कोशिश की जाती है.alt=media इस गड़बड़ी को दिखाने वाला 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."
  }
}

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

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

403 गड़बड़ियां

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

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

activeItemCreationLimitExceeded

activeItemCreationLimitExceeded गड़बड़ी तब होती है, जब हर खाते के लिए बनाए गए आइटम की संख्या की सीमा पार हो जाती है. हर उपयोगकर्ता के पास, किसी खाते से बनाए गए ज़्यादा से ज़्यादा 50 करोड़ आइटम हो सकते हैं. ज़्यादा जानकारी के लिए, उपयोगकर्ता-आइटम की सीमा देखें.

{
 "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

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

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 संसाधन को भी वापस पाया जा सकता है. इससे यह देखा जा सकता है कि शेयर की गई ड्राइव के इस आइटम पर अनुमतियां इनहेरिट की गई हैं या सीधे तौर पर लागू की गई हैं.

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. उपयोगकर्ता को निर्देश दें कि वह आपके ऐप्लिकेशन के लिए ऐक्सेस का अनुरोध करने के लिए, डोमेन एडमिन से संपर्क करे.

downloadRestrictedForRevision

यह गड़बड़ी तब होती है, जब उपयोगकर्ता किसी blob फ़ाइल के वर्शन को डाउनलोड नहीं कर पाता. नीचे दिए गए JSON के उदाहरण में, इस गड़बड़ी को दिखाया गया है:

{
  "error": {
    "errors": [
      {
        "domain": "global",
        "reason": "download_restricted_for_revision",
        "message": "This revision cannot be downloaded by the authenticated user."
      }
    ],
    "code": 403,
    "message": "This revision cannot be downloaded by the authenticated user."
  }
}

इस गड़बड़ी को ठीक करने के लिए, उपयोगकर्ता को बताएं कि blob फ़ाइल के वर्शन सिर्फ़ तब डाउनलोड किए जा सकते हैं, जब उन्हें "हमेशा के लिए रखें" के तौर पर मार्क किया गया हो. ज़्यादा जानकारी के लिए, अपने-आप मिटने से बचाने के लिए, बदलावों के बारे में बताएं लेख पढ़ें.

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/workspace/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/workspace/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. Drive, Gmail, और Google Photos में स्टोरेज मैनेज करें.

  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 गेटवे का टाइम आउट हो गया है

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