REST Resource: permissions

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

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

कुछ संसाधन तरीकों (जैसे कि 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

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

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