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

डोमेन एडमिन के तौर पर अनुरोध करें.

अगर इसे true पर सेट किया गया है और यहां दी गई अन्य शर्तें पूरी होती हैं, तो अनुरोध करने वाले व्यक्ति को ऐक्सेस दिया जाता है:

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

ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.

enforceExpansiveAccess

boolean

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

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

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

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

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

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

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

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

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