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

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