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

इस दस्तावेज़ में, 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 की वैल्यू पर सेट किया जाना चाहिए.