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

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

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

इस उपयोगकर्ता के लिए 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 API के दायरे चुनें सेक्शन में बताया गया है.

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

यह गड़बड़ी तब होती है, जब आपका ऐप्लिकेशन, फ़ाइल के लिए 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."
  }
}

इस गड़बड़ी को ठीक करने के लिए, शेयर की गई ड्राइव में आइटम की संख्या कम करें. बहुत सारी फ़ाइलों वाली शेयर की गई ड्राइव को व्यवस्थित करना और खोजना मुश्किल हो सकता है.

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

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