Method: permissions.create

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
emailMessage

string

सूचना वाले ईमेल में शामिल करने के लिए, सामान्य टेक्स्ट मैसेज.

enforceSingleParent
(deprecated)

boolean

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

moveToNewOwnersRoot

boolean

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

sendNotificationEmail

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

transferOwnership

boolean

क्या चुने गए उपयोगकर्ता को मालिकाना हक ट्रांसफ़र करना है और मौजूदा मालिक को लेखक में डाउनग्रेड करना है. इस पैरामीटर के लिए, साइड इफ़ेक्ट की पुष्टि करना ज़रूरी है.

useDomainAdminAccess

boolean

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

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

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

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

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

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

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

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

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