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

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

boolean

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

boolean

इस्तेमाल बंद कर दिया गया है: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
transferOwnership

boolean

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

boolean

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

boolean

क्या अनुरोध में, ऐक्सेस से जुड़े ज़्यादा नियमों को लागू किया जाना चाहिए.

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

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

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

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

अनुमति के स्कोप

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

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

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