REST Resource: permissions

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

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

डिफ़ॉल्ट रूप से, अनुमतियों के अनुरोध सिर्फ़ फ़ील्ड का सबसेट दिखाते हैं. अनुमति का टाइप, आईडी, टाइप, और भूमिका हमेशा दिखती है. खास फ़ील्ड वापस पाने के लिए, https://developers.google.com/drive/api/guides/fields-parameter पर जाएं.

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

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

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