Method: permissions.insert

किसी फ़ाइल या शेयर की गई ड्राइव के लिए अनुमति डालता है.

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

एचटीटीपी अनुरोध

POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
fileId

string

फ़ाइल या शेयर की गई ड्राइव का आईडी.

क्वेरी पैरामीटर

पैरामीटर
emailMessage

string

सूचना वाले ईमेल में शामिल करने के लिए, पसंद के मुताबिक बनाया गया सादा टेक्स्ट मैसेज.

enforceSingleParent
(deprecated)

boolean

अब काम नहीं करता: ज़्यादा जानकारी के लिए, moveToNewOwnersRoot देखें.

moveToNewOwnersRoot

boolean

यह पैरामीटर सिर्फ़ तब लागू होगा, जब आइटम किसी शेयर की गई ड्राइव में न हो और अनुरोध में आइटम का मालिकाना हक ट्रांसफ़र करने की कोशिश की जा रही हो. अगर इस विकल्प को true पर सेट किया जाता है, तो आइटम को नए मालिक के 'मेरी ड्राइव' रूट फ़ोल्डर में ले जाया जाएगा. साथ ही, उससे पहले के सभी पैरंट फ़ोल्डर हटा दिए जाएंगे. अगर इसे false पर सेट किया जाता है, तो माता-पिता की जानकारी में कोई बदलाव नहीं होता.

sendNotificationEmails

boolean

उपयोगकर्ताओं या ग्रुप के साथ शेयर करते समय, सूचना वाले ईमेल भेजने हैं या नहीं. अगर role की वैल्यू owner है, तो इस पैरामीटर को अनदेखा कर दिया जाता है और ईमेल भेज दिया जाता है.

supportsAllDrives

boolean

अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और शेयर की गई ड्राइव, दोनों के साथ काम करता है या नहीं.

supportsTeamDrives
(deprecated)

boolean

इस्तेमाल नहीं किया जा सकता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.

useDomainAdminAccess

boolean

डोमेन एडमिन के तौर पर अनुरोध करें. अगर इस विकल्प को 'सही' पर सेट किया जाता है, तो अनुरोध करने वाले व्यक्ति को ऐक्सेस दिया जाएगा. हालांकि, इसके लिए ज़रूरी है कि फ़ाइल आईडी पैरामीटर, शेयर की गई ड्राइव का रेफ़रंस देता हो और अनुरोध करने वाला व्यक्ति उस डोमेन का एडमिन हो जिससे शेयर की गई ड्राइव जुड़ी है.

enforceExpansiveAccess

boolean

अनुरोध में, ऐक्सेस के बड़े नियमों को लागू करना है या नहीं.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Permission का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Permission का नया इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.