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

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

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

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

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

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

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

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

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

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