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

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

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

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

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

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

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

मंज़ूरी पाना

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

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

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

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

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

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

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

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

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