अनुमतियां मैनेज करना

इस दस्तावेज़ में, Google Drive API में अनुमतियों को मैनेज करने का तरीका बताया गया है.

उपयोगकर्ता, मंज़ूरी लेने की औपचारिक प्रक्रिया के ज़रिए Google Drive में दस्तावेज़ भेज सकते हैं. इस प्रोसेस का इस्तेमाल, किसी अनुबंध की समीक्षा या पब्लिश करने से पहले किसी आधिकारिक दस्तावेज़ की मंज़ूरी पाने के लिए किया जा सकता है. मंज़ूरी से, समीक्षा की स्थिति (जैसे कि जारी है, मंज़ूरी मिल गई है या अस्वीकार कर दिया गया है) और इसमें शामिल समीक्षकों, दोनों के बारे में पता चलता है. अनुमति लेने की सुविधा, कॉन्टेंट की पुष्टि करने और समीक्षकों का रिकॉर्ड रखने का एक बेहतरीन तरीका है.

Drive में, कॉन्टेंट की मंज़ूरी देने की सुविधा को बनाया और मैनेज किया जा सकता है. Google Drive API, फ़ाइलों की मंज़ूरी से जुड़ी प्रोसेस को मैनेज करने के लिए approvals रिसॉर्स उपलब्ध कराता है. approvals संसाधन के तरीके, Drive, Google Docs, और अन्य Google Workspace एडिटर में मौजूद आइटम पर काम करते हैं. समीक्षा करने वाले लोग, सीधे तौर पर दस्तावेज़ों को स्वीकार या अस्वीकार कर सकते हैं या उन पर सुझाव दे सकते हैं.

शुरू करने से पहले

  1. आपकी फ़ाइल में canStartApproval सुविधा होनी चाहिए . फ़ाइल की क्षमताओं की जांच करने के लिए, files रिसॉर्स पर get तरीके को कॉल करें. इसके लिए, fileId पाथ पैरामीटर का इस्तेमाल करें. साथ ही, fields पैरामीटर में canStartApproval क्षमता फ़ील्ड का इस्तेमाल करें. ज़्यादा जानकारी के लिए, फ़ाइल की सुविधाओं के बारे में जानें लेख पढ़ें.

    canStartApproval की क्षमता false है, जब:

    • एडमिन की सेटिंग की वजह से, इस सुविधा को ऐक्सेस करने पर पाबंदी लगी है.
    • आपके Google Workspace वर्शन में यह सुविधा उपलब्ध नहीं है.
    • फ़ाइल का मालिकाना हक, आपके डोमेन से बाहर के किसी उपयोगकर्ता के पास है.
    • उपयोगकर्ता के पास फ़ाइल पर role=writer की अनुमति नहीं है.

  2. पक्का करें कि आपने टारगेट फ़ाइल को समीक्षकों के साथ मैन्युअल तरीके से शेयर किया हो. Drive ऐसा अपने-आप नहीं करता. अगर समीक्षक के पास फ़ाइल का ऐक्सेस नहीं है, तो अनुमति का अनुरोध पूरा हो जाएगा. हालांकि, उन्हें सूचनाएं नहीं मिलेंगी और वे फ़ाइल नहीं देख पाएंगे.

कॉन्सेप्ट

यहाँ कुछ ऐसे अहम कॉन्सेप्ट दिए गए हैं जो मंज़ूरी पाने के लिए ज़रूरी हैं.

समीक्षा की स्थिति

किसी दस्तावेज़ को मंज़ूरी देने का अनुरोध करने पर, मंज़ूरी देने की प्रोसेस यह पक्का करती है कि हर समीक्षक, दस्तावेज़ पर अपनी राय दे सके.

approvals संसाधन में एक Status ऑब्जेक्ट शामिल होता है. इससे संसाधन का अनुरोध किए जाने पर, अनुमति की स्थिति के बारे में जानकारी मिलती है. इसमें ReviewerResponse ऑब्जेक्ट भी शामिल होता है. इसमें, खास समीक्षकों की दी गई मंज़ूरी के जवाबों के बारे में जानकारी होती है. समीक्षा करने वाले हर व्यक्ति के जवाब को Response ऑब्जेक्ट से दिखाया जाता है.

अनुमति Status के IN_PROGRESS होने के दौरान, फ़ाइल के कॉन्टेंट में बदलाव करने पर अनुमति मिलने की प्रोसेस कैसी होगी, यह approvals संसाधन के fileContentChangeBehavior फ़ील्ड से तय होता है. ये व्यवहार लागू किए जा सकते हैं:

  • RESET_APPROVAL: अनुमति देने की प्रोसेस से यह पक्का किया जाता है कि हर समीक्षक, कॉन्टेंट के एक ही वर्शन को अनुमति दे. अगर समीक्षक के अनुरोध को मंज़ूरी देने के बाद और अनुरोध पूरा होने से पहले फ़ाइल में बदलाव किया जाता है, तो समीक्षक की अनुमतियां रीसेट हो जाती हैं. यानी, जवाब को वापस NO_RESPONSE पर सेट कर दिया जाता है. इसके बाद, समीक्षकों को नए वर्शन को मंज़ूरी देनी होगी. जब अनुमति की स्थिति APPROVED होती है, तो फ़ाइल लॉक हो जाती है, ताकि उसमें कोई और बदलाव न किया जा सके. आखिरी मंज़ूरी मिलने के बाद, कॉन्टेंट में किए गए अतिरिक्त बदलावों की वजह से, दस्तावेज़ पर एक बैनर दिखेगा. इससे पता चलेगा कि मौजूदा वर्शन, मंज़ूरी वाले वर्शन से अलग है. यह डिफ़ॉल्ट व्यवहार है.

  • NO_APPROVAL_ACTION: अनुमति मिलने से पहले, फ़ाइल के कॉन्टेंट में बदलाव करने पर, समीक्षक के फ़ैसले रीसेट नहीं होते. इसके अलावा, फ़ाइल को मंज़ूरी मिलने के बाद लॉक नहीं किया जाता. समीक्षक, अनुमति देने की प्रोसेस पूरी होने से पहले, कभी भी APPROVED के फ़ैसले को 'लंबित' स्थिति पर रीसेट कर सकते हैं. इसका मतलब है कि जवाब को वापस NO_RESPONSE पर सेट किया जा सकता है.

अनुमति मिल जाने के बाद, यह व्यवहार लागू नहीं होता.

अनुमति मिलने की प्रोसेस में होने वाली हर कार्रवाई से, ईमेल सूचनाएं जनरेट होती हैं. ये सूचनाएं, अनुरोध करने वाले उपयोगकर्ता और सभी समीक्षकों को भेजी जाती हैं. इसे अनुमति से जुड़ी गतिविधि के लॉग में भी जोड़ा जाता है.

सभी समीक्षकों को मंज़ूरी देनी होगी. समीक्षा करने वाला कोई भी व्यक्ति, अनुमति देने से इनकार कर सकता है. ऐसा करने पर, स्थिति DECLINED पर सेट हो जाती है.

अनुमति मिलने के बाद (स्थिति APPROVED, CANCELLED या DECLINED है), यह 'पूरा हो गया' स्थिति में रहती है. साथ ही, इसे शुरू करने वाला व्यक्ति या समीक्षक इसमें कोई बदलाव नहीं कर सकते. अनुमति मिलने के बाद भी टिप्पणियां जोड़ी जा सकती हैं. हालांकि, ऐसा तब तक किया जा सकता है, जब तक किसी फ़ाइल पर IN_PROGRESS स्थिति वाली कोई मौजूदा अनुमति न हो.

अनुमति की लाइफ़साइकल

मंज़ूरी का लाइफ़साइकल.
पहली इमेज. मंज़ूरी की लाइफ़साइकल.

अनुमोदन के लाइफ़साइकल के दौरान, उसकी स्थिति कई बार बदलती है. पहली इमेज में, अनुमति मिलने के लाइफ़साइकल के मुख्य चरण दिखाए गए हैं:

  1. अनुमति देने की प्रोसेस शुरू करें. अनुमति का अनुरोध करने के लिए, start पर कॉल करें. इसके बाद, status को IN_PROGRESS पर सेट किया जाता है.

  2. मंज़ूरी मिलना बाकी है. मंज़ूरी मिलने तक (status को IN_PROGRESS पर सेट किया जाता है), अनुरोध करने वाला व्यक्ति और समीक्षक, दोनों इससे इंटरैक्ट कर सकते हैं. वे comment जोड़ सकते हैं, अनुरोध करने वाला व्यक्ति समीक्षकों को reassign कर सकता है, और एक या उससे ज़्यादा समीक्षक अनुरोध को approve कर सकते हैं.

  3. अनुमति देने की प्रोसेस पूरी हो गई है. जब सभी समीक्षक अनुरोध को मंज़ूरी दे देते हैं, अनुरोध करने वाला व्यक्ति अनुरोध को cancel कर देता है या कोई समीक्षक अनुरोध को decline कर देता है, तब मंज़ूरी की स्थिति 'पूरा हुआ' (status को APPROVED, CANCELLED या DECLINED पर सेट किया जाता है) पर सेट हो जाती है.

फ़ील्ड पैरामीटर का इस्तेमाल करना

अगर आपको जवाब में दिखाए जाने वाले फ़ील्ड तय करने हैं, तो approvals रिसॉर्स के किसी भी तरीके के साथ fields सिस्टम पैरामीटर सेट किया जा सकता है. fields पैरामीटर को शामिल न करने पर, सर्वर, तरीके के हिसाब से फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. अलग-अलग फ़ील्ड वापस पाने के लिए, चुनिंदा फ़ील्ड वापस पाना लेख पढ़ें.

अनुमतियां पाना और उन्हें मैनेज करना

approvals संसाधन का इस्तेमाल करके, Drive API की मदद से मंज़ूरी दी जा सकती है और उन्हें मैनेज किया जा सकता है. ये तरीके, Drive API के किसी भी मौजूदा OAuth 2.0 स्कोप के साथ काम करते हैं. इन स्कोप की मदद से, फ़ाइल के मेटाडेटा को लिखा जा सकता है. ज़्यादा जानकारी के लिए, Google Drive API के स्कोप चुनना लेख पढ़ें.

अनुमति पाने की प्रोसेस शुरू करना

किसी फ़ाइल के लिए नई मंज़ूरी का अनुरोध करने के लिए, approvals संसाधन पर start तरीके का इस्तेमाल करें. साथ ही, fileId पाथ पैरामीटर शामिल करें.

अनुरोध के मुख्य हिस्से में, ज़रूरी reviewerEmails फ़ील्ड होता है. यह स्ट्रिंग का एक ऐसा कलेक्शन होता है जिसमें फ़ाइल की समीक्षा करने के लिए असाइन किए गए समीक्षकों के ईमेल पते शामिल होते हैं. हर समीक्षक का ईमेल पता, किसी Google खाते से जुड़ा होना चाहिए. ऐसा न होने पर, अनुरोध पूरा नहीं किया जा सकेगा. इसके अलावा, चार ऐसे फ़ील्ड भी उपलब्ध हैं जिन्हें भरना ज़रूरी नहीं है:

  • dueTime: आरएफ़सी 3339 फ़ॉर्मैट में मंज़ूरी पाने की समयसीमा.
  • lockFile: बूलियन वैल्यू से पता चलता है कि अनुमति पाने की प्रोसेस शुरू होने पर फ़ाइल को लॉक करना है या नहीं. इससे, अनुमति की प्रोसेस के दौरान उपयोगकर्ताओं को फ़ाइल में बदलाव करने से रोका जाता है. जिस उपयोगकर्ता के पास role=writer अनुमति है वह इस लॉक को हटा सकता है.
  • message: समीक्षकों को भेजा गया कस्टम मैसेज.
  • fileContentChangeBehavior: फ़ाइल के कॉन्टेंट में बदलाव होने पर, अनुमति मिलने की प्रोसेस का व्यवहार. इन वैल्यू का इस्तेमाल किया जा सकता है:
    • RESET_APPROVAL: (डिफ़ॉल्ट) अनुमति देने की प्रोसेस के दौरान कॉन्टेंट में बदलाव होने पर, समीक्षक के APPROVED जवाब को NO_RESPONSE पर रीसेट करता है. अनुमति मिलने के बाद, फ़ाइल लॉक हो जाती है. इसका स्टेटस APPROVED होता है.
    • NO_APPROVAL_ACTION: कॉन्टेंट में बदलाव होने पर, समीक्षा करने वाले लोगों के जवाब रीसेट नहीं होते. साथ ही, अनुमति मिलने के बाद फ़ाइल लॉक नहीं होती.

जवाब के मुख्य हिस्से में approvals संसाधन का एक उदाहरण होता है. इसमें initiator फ़ील्ड शामिल होता है. यह फ़ील्ड, मंज़ूरी का अनुरोध करने वाले उपयोगकर्ता के बारे में जानकारी देता है. Status के लिए अनुमति की स्थिति IN_PROGRESS पर सेट है.

अगर Status की वैल्यू IN_PROGRESS के साथ कोई मौजूदा अनुमति मौजूद है, तो start तरीका काम नहीं करेगा. अनुमति पाने की प्रोसेस सिर्फ़ तब शुरू की जा सकती है, जब फ़ाइल के लिए अनुमति पाने की कोई प्रोसेस पहले से चल न रही हो. इसके अलावा, ऐसा तब भी किया जा सकता है, जब अनुमति पाने की मौजूदा प्रोसेस पूरी हो चुकी हो. इस स्थिति में, स्टेटस APPROVED, CANCELLED या DECLINED होता है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals:start' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "reviewerEmails": [
     "reviewer1@example.com",
     "reviewer2@example.com"
    ],
    "dueTime": "2026-04-01T15:01:23Z",
    "lockFile": true,
    "message": "Please review this file for approval.",
    "fileContentChangeBehavior": "RESET_APPROVAL"
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मंज़ूरी देने के बारे में टिप्पणी

किसी अनुरोध को मंज़ूरी देने के बारे में टिप्पणी करने के लिए, approvals संसाधन पर comment तरीके का इस्तेमाल करें. साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

अनुरोध के मुख्य हिस्से में, ज़रूरी message फ़ील्ड होता है. यह एक स्ट्रिंग होती है, जिसमें वह टिप्पणी शामिल होती है जिसे आपको मंज़ूरी में जोड़ना है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है. यह मैसेज, अनुमति देने का अनुरोध करने वाले व्यक्ति और समीक्षकों को सूचना के तौर पर भेजा जाता है. साथ ही, इसे अनुमति देने से जुड़ी गतिविधि के लॉग में भी शामिल किया जाता है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:comment' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "message": "The required comment on the approval."
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मंज़ूरी मिलने पर समीक्षकों को फिर से असाइन करना

अनुमति के लिए समीक्षकों को फिर से असाइन करने के लिए, approvals संसाधन पर reassign तरीके का इस्तेमाल करें. साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

reassign तरीके से, अनुमति का अनुरोध करने वाला व्यक्ति (या role=writer अनुमति वाला उपयोगकर्ता), approvals रिसॉर्स के ReviewerResponse ऑब्जेक्ट में समीक्षकों को जोड़ सकता है या उन्हें बदल सकता है. role=reader अनुमति वाला उपयोगकर्ता, सिर्फ़ उस मंज़ूरी को फिर से असाइन कर सकता है जो उसे असाइन की गई है. इससे उपयोगकर्ता, समीक्षा के अनुरोध को किसी ऐसे व्यक्ति को फिर से असाइन कर सकता है जो बेहतर तरीके से समीक्षा कर सकता है.

समीक्षकों को सिर्फ़ तब फिर से असाइन किया जा सकता है, जब Status IN_PROGRESS हो और जिस समीक्षक को फिर से असाइन किया जा रहा है उसके लिए response फ़ील्ड NO_RESPONSE पर सेट हो.

ध्यान दें कि किसी समीक्षा करने वाले व्यक्ति को मंज़ूरी देने के बाद, उसे हटाया नहीं जा सकता. अगर आपको किसी समीक्षक को हटाना है, तो आपको अनुमति रद्द करके, नया अनुरोध करना होगा.

अनुरोध के मुख्य हिस्से में, addReviewers और replaceReviewers फ़ील्ड शामिल होते हैं. हालांकि, इनकी वैल्यू देना ज़रूरी नहीं है. हर फ़ील्ड में, AddReviewer और ReplaceReviewer के लिए दोहराया गया ऑब्जेक्ट होता है. इनमें से हर ऑब्जेक्ट में, समीक्षा करने वाले एक व्यक्ति को जोड़ने या समीक्षा करने वाले दो लोगों को बदलने की जानकारी होती है. आपके पास message फ़ील्ड जोड़ने का विकल्प भी होता है. इसमें वह टिप्पणी शामिल होती है जिसे आपको नए समीक्षकों को भेजना है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है. यह मैसेज, नए समीक्षकों को सूचना के तौर पर भेजा जाता है. साथ ही, इसे अनुमति देने से जुड़ी गतिविधि के लॉग में भी शामिल किया जाता है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:reassign' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "addReviewers": [
    {
        "addedReviewerEmail": "new_reviewer@example.com"
    }
    ],
    "replaceReviewers": [
    {
        "addedReviewerEmail": "replacement_reviewer@example.com",
        "removedReviewerEmail": "old_reviewer@example.com"
    }
    ],
    "message": "Reassigning reviewers for this approval request."
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

अनुमति रद्द करना

अनुमति रद्द करने के लिए, approvals संसाधन पर cancel तरीके का इस्तेमाल करें. साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

cancel तरीके को सिर्फ़ अनुमति का अनुरोध करने वाला व्यक्ति (या role=writer अनुमति वाला उपयोगकर्ता) कॉल कर सकता है. ऐसा तब किया जा सकता है, जब अनुमति Status IN_PROGRESS हो.

अनुरोध के मुख्य हिस्से में एक message फ़ील्ड होता है. यह फ़ील्ड एक स्ट्रिंग होता है. इसमें मंज़ूरी रद्द करने के साथ-साथ मैसेज भी शामिल होता है. हालांकि, इस फ़ील्ड को शामिल करना ज़रूरी नहीं है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है. यह मैसेज, सूचना के तौर पर भेजा जाता है. साथ ही, इसे अनुमति देने से जुड़ी गतिविधि के लॉग में भी शामिल किया जाता है. अनुमति Status को CANCELLED पर सेट किया गया है और यह पूरी हो चुकी है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:cancel' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "message": "The optional reason for cancelling this approval request."
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मंज़ूरी न दें

अनुमति अस्वीकार करने के लिए, approvals रिसॉर्स पर decline तरीके का इस्तेमाल करें. साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

decline तरीके को सिर्फ़ तब कॉल किया जा सकता है, जब अनुमति Status IN_PROGRESS हो.

अनुरोध के मुख्य हिस्से में एक message फ़ील्ड होता है. यह फ़ील्ड एक स्ट्रिंग होती है. इसमें मंज़ूरी न मिलने की वजह के साथ-साथ मैसेज भी शामिल होता है. हालांकि, इस फ़ील्ड में जानकारी देना ज़रूरी नहीं है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है. यह मैसेज, सूचना के तौर पर भेजा जाता है. साथ ही, इसे अनुमति देने से जुड़ी गतिविधि के लॉग में भी शामिल किया जाता है. अनुरोध करने वाले उपयोगकर्ता के ReviewerResponse ऑब्जेक्ट का response फ़ील्ड, DECLINED पर सेट है. इसके अलावा, मंज़ूरी की स्थिति Status को DECLINED पर सेट किया गया है और यह पूरी हो चुकी है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:decline' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "message": "The optional reason for declining this approval request."
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मंज़ूरी देना

किसी अनुरोध को स्वीकार करने के लिए, approvals रिसॉर्स पर approve तरीके का इस्तेमाल करें. साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

approve तरीके को सिर्फ़ तब कॉल किया जा सकता है, जब अनुमति Status IN_PROGRESS हो.

अनुरोध के मुख्य हिस्से में, एक वैकल्पिक message फ़ील्ड होता है. यह एक स्ट्रिंग होती है, जिसमें मंज़ूरी के साथ शामिल करने के लिए मैसेज होता है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है. यह मैसेज, सूचना के तौर पर भेजा जाता है. साथ ही, इसे अनुमति देने से जुड़ी गतिविधि के लॉग में भी शामिल किया जाता है. अनुरोध करने वाले उपयोगकर्ता के ReviewerResponse ऑब्जेक्ट का response फ़ील्ड, APPROVED पर सेट है. इसके अलावा, अगर यह समीक्षक का आखिरी जवाब है, तो मंज़ूरी Status को APPROVED पर सेट कर दिया जाता है और इसकी स्थिति 'पूरा हुआ' हो जाती है.

curl

curl -X POST 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID:approve' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
    "message": "The optional reason for approving this approval request."
 }'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मौजूदा अनुमतियां ढूंढना

Drive API का इस्तेमाल करके, approvals संसाधन का इस्तेमाल, अनुमतियों की स्थिति पाने और उनकी सूची बनाने के लिए भी किया जा सकता है.

किसी फ़ाइल पर मिली अनुमतियां देखने के लिए, आपके पास उस फ़ाइल का मेटाडेटा पढ़ने की अनुमति होनी चाहिए. ज़्यादा जानकारी के लिए, भूमिकाएं और अनुमतियां लेख पढ़ें.

मंज़ूरी पाना

किसी फ़ाइल को मंज़ूरी देने के लिए, fileId और approvalId पाथ पैरामीटर के साथ approvals संसाधन पर get तरीके का इस्तेमाल करें. अगर आपको अनुमति आईडी नहीं पता है, तो list तरीके का इस्तेमाल करके, अनुमतियों की सूची देखी जा सकती है.

जवाब के मुख्य हिस्से में, approvals संसाधन का एक इंस्टेंस होता है.

curl

curl -X GET 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals/APPROVAL_ID' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Accept: application/json'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • APPROVAL_ID: मंज़ूरी का आईडी.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.

मंज़ूरी की सूची

किसी फ़ाइल पर अनुमतियों की सूची बनाने के लिए, approvals संसाधन पर list तरीके को कॉल करें. साथ ही, fileId पाथ पैरामीटर शामिल करें.

जवाब के मुख्य हिस्से में, फ़ाइल को अनुमति देने से जुड़ी जानकारी की सूची होती है. items फ़ील्ड में, हर मंज़ूरी के बारे में जानकारी शामिल होती है. यह जानकारी, approvals रिसॉर्स के तौर पर होती है.

अनुमोदन की सूची में पेज नंबर बदलने या फ़िल्टर करने के लिए, यहां दिए गए क्वेरी पैरामीटर भी पास किए जा सकते हैं:

  • pageSize: हर पेज पर, प्रॉडक्ट लौटाने के लिए ज़्यादा से ज़्यादा कितने अनुरोध स्वीकार किए जा सकते हैं. अगर आपने pageSize सेट नहीं किया है, तो सर्वर ज़्यादा से ज़्यादा 100 अनुमतियां दिखाता है.

  • pageToken: यह एक पेज टोकन है, जो सूची बनाने के लिए किए गए पिछले कॉल से मिला है. इस टोकन का इस्तेमाल, अगले पेज को वापस पाने के लिए किया जाता है. इसे पिछले जवाब में मौजूद nextPageToken की वैल्यू पर सेट किया जाना चाहिए.

curl

curl -X GET 'https://www.googleapis.com/drive/v3/files/FILE_ID/approvals?pageSize=10' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Accept: application/json'

इनकी जगह ये डालें:

  • FILE_ID: यह उस फ़ाइल का आईडी है जिसके लिए अनुमति दी गई है.
  • ACCESS_TOKEN: आपके ऐप्लिकेशन का OAuth 2.0 टोकन.