REST Resource: permissions

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

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

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

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

string

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

object

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

string

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

  • file
  • member
permissionDetails[].role

string

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

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

string

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

string

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

boolean

सिर्फ़ आउटपुट के लिए. यह अनुमति इनहेरिट की गई है या नहीं. इस फ़ील्ड में हमेशा जानकारी होती है.
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 का इस्तेमाल करें.
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
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.
expirationDate

string

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

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

boolean

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

string

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

published

और

metadata

का इस्तेमाल किया जा सकता है.

  • published

    : अनुमति की भूमिका published_reader है.

  • metadata

    : आइटम सिर्फ़ मेटाडेटा व्यू में दिखता है, क्योंकि आइटम का ऐक्सेस सीमित है और स्कोप के पास पैरंट का कम से कम रीड ऐक्सेस है. ध्यान दें:

    metadata

    फ़िलहाल, यह सुविधा सिर्फ़ फ़ोल्डर के लिए उपलब्ध है.

pendingOwner

boolean

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

boolean

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

तरीके

delete

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

get

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

getIdForEmail

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

insert

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

list

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

patch

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

update

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