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

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

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.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

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

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

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