REST Resource: permissions

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

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

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

JSON के काेड में दिखाना
{
  "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

वह समय जब यह अनुमति खत्म हो जाएगी (RFC 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

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