REST Resource: permissions

संसाधन: अनुमति

किसी फ़ाइल के लिए अनुमति. अनुमति से किसी उपयोगकर्ता, ग्रुप, डोमेन या दुनिया को किसी फ़ाइल या फ़ोल्डर की हैरारकी का ऐक्सेस मिलता है.

संसाधन के कुछ तरीकों (जैसे कि permissions.update) के लिए, permissionId की ज़रूरत होती है. किसी फ़ाइल, फ़ोल्डर या शेयर की गई ड्राइव का आईडी वापस पाने के लिए, permissions.list तरीके का इस्तेमाल करें.

जेएसओएन के काेड में दिखाना
{
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean
}
फ़ील्ड
id

string

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

displayName

string

सिर्फ़ आउटपुट के लिए. अनुमति की वैल्यू का "बहुत अच्छा" नाम. यहां हर तरह की अनुमति के उदाहरण दिए गए हैं:

  • user - उपयोगकर्ता का पूरा नाम, जैसा कि उनके Google खाते में बताया गया है, जैसे कि "अक्षय कुमार."
  • group - Google ग्रुप का नाम, जैसे कि "कंपनी के एडमिन."
  • domain - स्ट्रिंग का डोमेन नेम, जैसे कि "thecompany.com."
  • anyone - कोई displayName मौजूद नहीं है.
type

string

अनुदान पाने वाले का टाइप. मान्य मान हैं:

  • user
  • group
  • domain
  • anyone

अनुमति बनाते समय, अगर type user या group है, तो आपको उपयोगकर्ता या ग्रुप के लिए emailAddress देना होगा. अगर type, domain है, तो आपको domain देना होगा. anyone टाइप के लिए ज़्यादा जानकारी की ज़रूरत नहीं है.

kind

string

सिर्फ़ आउटपुट के लिए. यह बताता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग "drive#permission".

permissionDetails[]

object

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

permissionDetails[].permissionType

string

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

  • file
  • member
permissionDetails[].inheritedFrom

string

सिर्फ़ आउटपुट के लिए. उस आइटम का आईडी जिससे यह अनुमति मिली है. यह सिर्फ़ आउटपुट वाला फ़ील्ड है.

permissionDetails[].role

string

सिर्फ़ आउटपुट के लिए. इस उपयोगकर्ता के लिए मुख्य भूमिका. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. हालांकि, फ़िलहाल ये काम किए जा सकते हैं:

  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inherited

boolean

सिर्फ़ आउटपुट के लिए. क्या यह अनुमति इनहेरिट की गई है. इस फ़ील्ड में हमेशा अपने-आप जानकारी भरी जाती है. यह सिर्फ़ आउटपुट वाला फ़ील्ड है.

emailAddress

string

उस उपयोगकर्ता या ग्रुप का ईमेल पता जिससे यह अनुमति मिली है.

role

string

इस अनुमति से मिली भूमिका. आने वाले समय में, नई वैल्यू इस्तेमाल की जा सकती हैं. हालांकि, फ़िलहाल इनकी अनुमति है:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
allowFileDiscovery

boolean

अनुमति मिलने पर, फ़ाइल को खोज के ज़रिए खोजा जा सकता है या नहीं. यह सिर्फ़ domain या anyone टाइप की अनुमतियों के लिए लागू होता है.

domain

string

वह डोमेन जिससे यह अनुमति जुड़ी है.

expirationTime

string

इस अनुमति के खत्म होने का समय (आरएफ़सी 3339 तारीख और समय). समयसीमा खत्म होने के समय पर ये पाबंदियां लागू होती हैं:

  • उन्हें सिर्फ़ उपयोगकर्ता और ग्रुप की अनुमतियों पर सेट किया जा सकता है.
  • समय भविष्य में होना चाहिए.
  • समय, आने वाले एक साल से ज़्यादा का नहीं हो सकता.
teamDrivePermissionDetails[]
(deprecated)

object

सिर्फ़ आउटपुट के लिए. अब सेवा में नहीं है: सिर्फ़ आउटपुट के लिए. इसके बजाय, permissionDetails का इस्तेमाल करें.

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

अब सेवा में नहीं है: सिर्फ़ आउटपुट के लिए. इसके बजाय, permissionDetails/permissionType का इस्तेमाल करें.

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

अब सेवा में नहीं है: सिर्फ़ आउटपुट के लिए. इसके बजाय, permissionDetails/inheritedFrom का इस्तेमाल करें.

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

अब सेवा में नहीं है: सिर्फ़ आउटपुट के लिए. इसके बजाय, permissionDetails/role का इस्तेमाल करें.

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

अब सेवा में नहीं है: सिर्फ़ आउटपुट के लिए. इसके बजाय, permissionDetails/inherited का इस्तेमाल करें.

deleted

boolean

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

view

string

यह अनुमति दिखाता है. सिर्फ़ किसी व्यू से जुड़ी अनुमतियों के लिए जानकारी अपने-आप भर जाती है. 'पब्लिश किया गया' ही एक ऐसा वैल्यू है जिसका इस्तेमाल किया जा सकता है.

pendingOwner

boolean

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

तरीके

create

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

delete

अनुमति को मिटाता है.

get

आईडी के हिसाब से अनुमति देता है.

list

यह डायलॉग बॉक्स, किसी फ़ाइल या शेयर की गई ड्राइव की अनुमतियों की सूची बनाता है.

update

पैच सिमैंटिक के साथ अनुमति अपडेट करता है.