- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- इसे आज़माएं!
किसी फ़ाइल या शेयर की गई ड्राइव के लिए अनुमति बनाता है.
चेतावनी: एक ही फ़ाइल पर, अनुमतियों के लिए एक साथ कई कार्रवाइयां नहीं की जा सकतीं. सिर्फ़ आखिरी अपडेट लागू होता है.
एचटीटीपी अनुरोध
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
| पैरामीटर | |
|---|---|
fileId |
फ़ाइल या शेयर की गई ड्राइव का आईडी. |
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
emailMessage |
सूचना वाले ईमेल में शामिल करने के लिए, अपनी पसंद का कोई सादा टेक्स्ट मैसेज. |
enforceSingleParent |
अब काम नहीं करता: ज़्यादा जानकारी के लिए |
moveToNewOwnersRoot |
यह पैरामीटर सिर्फ़ तब लागू होगा, जब आइटम किसी शेयर की गई ड्राइव में न हो और अनुरोध में आइटम का मालिकाना हक ट्रांसफ़र करने की कोशिश की जा रही हो. अगर इसकी वैल्यू |
sendNotificationEmail |
उपयोगकर्ताओं या ग्रुप के साथ शेयर करते समय, सूचना वाला ईमेल भेजना है या नहीं. यह डिफ़ॉल्ट रूप से, उपयोगकर्ताओं और ग्रुप के लिए 'सही है' पर सेट होता है. साथ ही, अन्य अनुरोधों के लिए इसकी अनुमति नहीं है. मालिकाना हक ट्रांसफ़र करने के लिए, यह सुविधा बंद नहीं होनी चाहिए. |
supportsAllDrives |
अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और शेयर की गई ड्राइव, दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
इस्तेमाल नहीं किया जा सकता: इसके बजाय, |
transferOwnership |
चुने गए उपयोगकर्ता को मालिकाना हक ट्रांसफ़र करना है या नहीं. साथ ही, मौजूदा मालिक को लेखक के तौर पर डाउनग्रेड करना है या नहीं. साइड इफ़ेक्ट की पुष्टि करने के लिए, यह पैरामीटर ज़रूरी है. |
useDomainAdminAccess |
डोमेन एडमिन के तौर पर अनुरोध करें. अगर इस पैरामीटर को 'सही' पर सेट किया जाता है, तो अनुरोध करने वाले व्यक्ति को ऐक्सेस दिया जाएगा. हालांकि, इसके लिए ज़रूरी है कि फ़ाइल आईडी पैरामीटर, शेयर की गई ड्राइव का रेफ़रंस देता हो और अनुरोध करने वाला व्यक्ति उस डोमेन का एडमिन हो जिससे शेयर की गई ड्राइव जुड़ी है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Permission का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Permission का नया इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.file
कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.