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

इस दस्तावेज़ में, 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 ऑब्जेक्ट से दिखाया जाता है.

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

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

fields पैरामीटर का इस्तेमाल करना

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

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

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

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

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

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

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

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

अगर StatusIN_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 टोकन.

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

मंज़ूरी पर टिप्पणी करने के लिए, 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 तरीके का इस्तेमाल करें.approvals साथ ही, fileId और approvalId पाथ पैरामीटर शामिल करें.

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 टोकन.

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

किसी फ़ाइल के लिए, मंज़ूरी की प्रोसेस की सूची बनाने के लिए, 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&fields=nextPageToken,items(approvalId,status)' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Accept: application/json'

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

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