REST Resource: permissions

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

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

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

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

string

उस उपयोगकर्ता का आईडी जिसके बारे में यह अनुमति दी गई है. साथ ही, यह आईडी, जानकारी और फ़ाइल संसाधनों में मौजूद permissionId से मेल खाता है. drive.permissions.insert का अनुरोध करते समय, id या value में से कोई एक फ़ील्ड देना ज़रूरी है. हालांकि, अगर अनुमति का टाइप anyone न हो, तो id और value, दोनों को अनदेखा कर दिया जाएगा.

name

string

सिर्फ़ आउटपुट के लिए. इस अनुमति का नाम.

type

string

खाता टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है:

  • user
  • group
  • domain
  • anyone
role

string

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

  • owner
  • organizer
  • fileOrganizer
  • writer
  • reader
additionalRoles[]

string

इस उपयोगकर्ता के लिए अतिरिक्त भूमिकाएं. फ़िलहाल, सिर्फ़ commenter को अनुमति दी गई है. हालांकि, आने वाले समय में और भी सुविधाएं उपलब्ध हो सकती हैं.

authKey
(deprecated)

string

सिर्फ़ आउटपुट के लिए. समर्थन नहीं होना या रुकना.

value

string

इकाई का ईमेल पता या डोमेन नेम. इसका इस्तेमाल डेटा डालने के दौरान किया जाता है और यह जवाबों में अपने-आप नहीं भरता. drive.permissions.insert का अनुरोध करते समय, id या value में से कोई एक फ़ील्ड देना ज़रूरी है. हालांकि, अगर अनुमति का टाइप anyone न हो, तो id और value, दोनों को अनदेखा कर दिया जाएगा.

kind

string

सिर्फ़ आउटपुट के लिए. यह हमेशा drive#permission होता है.

emailAddress

string

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

domain

string

सिर्फ़ आउटपुट के लिए. उस इकाई का डोमेन नेम जिससे यह अनुमति मिली है. यह एक आउटपुट फ़ील्ड है, जो तब मौजूद होता है, जब अनुमति का टाइप user, group या domain होता है.

etag

string

सिर्फ़ आउटपुट के लिए. अनुमति का ETag.

permissionDetails[]

object

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

permissionDetails[].permissionType

string

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

  • file
  • member
permissionDetails[].role

string

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

  • organizer
  • fileOrganizer
  • writer
  • reader
permissionDetails[].additionalRoles[]

string

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

permissionDetails[].inheritedFrom

string

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

permissionDetails[].inherited

boolean

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

expirationDate

string

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

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

object

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

teamDrivePermissionDetails[]
(deprecated).teamDrivePermissionType
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).role
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).additionalRoles[]
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inheritedFrom
(deprecated)

string

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

teamDrivePermissionDetails[]
(deprecated).inherited
(deprecated)

boolean

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

deleted

boolean

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

view

string

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

pendingOwner

boolean

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

तरीके

delete

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

get

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

getIdForEmail

किसी ईमेल पते के लिए अनुमति आईडी दिखाता है.

insert

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

list

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

patch

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

update

अनुमति को अपडेट करता है.