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
(deprecated)

boolean

बंद कर दिया गया: सभी अनुरोधों के लिए, ऐक्सेस से जुड़े नियमों का इस्तेमाल किया जाता है.

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

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

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

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

अनुमति पाने के लिंक

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

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

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