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

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

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

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

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

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

    बूलियन canStartApproval सुविधा, इन स्थितियों में false होती है:

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

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

कॉन्सेप्ट

मंज़ूरी की प्रोसेस के लिए, ये अहम कॉन्सेप्ट ज़रूरी हैं.

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

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

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

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

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

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

मंज़ूरी की लाइफ़साइकल

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

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

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

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

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

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

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

मंज़ूरी की प्रोसेस शुरू करना और उसे मैनेज करना

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

मंज़ूरी की प्रोसेस शुरू करना

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

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

  • dueTime: आरएफ़सी 3339 फ़ॉर्मैट में, मंज़ूरी की समयसीमा.
  • lockFile: यह बूलियन, यह दिखाता है कि मंज़ूरी की प्रोसेस शुरू करते समय फ़ाइल को लॉक करना है या नहीं. इससे, मंज़ूरी की प्रोसेस के दौरान, उपयोगकर्ता फ़ाइल में बदलाव नहीं कर पाते. role=writer की अनुमति वाला कोई भी उपयोगकर्ता, इस लॉक को हटा सकता है.
  • message: समीक्षा करने वाले लोगों को भेजा गया कोई कस्टम मैसेज.

जवाब के मुख्य हिस्से में, 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."
 }'

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

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

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

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

अनुरोध के मुख्य हिस्से में, 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 टोकन.

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

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

reassign तरीके की मदद से, मंज़ूरी का अनुरोध करने वाला व्यक्ति (या role=writer की अनुमति वाला कोई उपयोगकर्ता), ReviewerResponse ऑब्जेक्ट में समीक्षा करने वाले लोगों को जोड़ या बदल सकता है approvals संसाधन का. 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 टोकन.

मंज़ूरी की प्रोसेस रद्द करना

मंज़ूरी की प्रोसेस रद्द करने के लिए, cancel तरीके का इस्तेमाल करें. साथ ही, approvals संसाधन पर 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 टोकन.

मंज़ूरी की प्रोसेस को अस्वीकार करना

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

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 संसाधन की मदद से, मंज़ूरी की प्रोसेस की स्थिति देखी जा सकती है और उनकी सूची बनाई जा सकती है.

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

मंज़ूरी की प्रोसेस की जानकारी पाना

किसी फ़ाइल पर मंज़ूरी की प्रोसेस की जानकारी पाने के लिए, get तरीके का इस्तेमाल approvals संसाधन पर fileId और approvalId पाथ पैरामीटर के साथ करें. अगर आपको मंज़ूरी का आईडी नहीं पता है, तो list मंज़ूरी की प्रोसेस को 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 टोकन.

मंज़ूरी की प्रोसेस की सूची बनाना

किसी फ़ाइल पर मंज़ूरी की प्रोसेस की सूची बनाने के लिए, list तरीके को approvals संसाधन पर कॉल करें. साथ ही, 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 टोकन.