REST Resource: permissions

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

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

डिफ़ॉल्ट रूप से, अनुमति के अनुरोधों से सिर्फ़ फ़ील्ड का सबसेट मिलता है. अनुमति kind, ID, type, और role हमेशा दिखाई जाती हैं. किसी खास फ़ील्ड को वापस पाने के लिए, खास फ़ील्ड वापस पाना लेख पढ़ें.

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

JSON के काेड में दिखाना 
{
  "permissionDetails": [
    {
      "permissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "inheritedFrom": string,
      "role": string,
      "inherited": boolean
    }
  ],
  "id": string,
  "displayName": string,
  "type": string,
  "kind": string,
  "photoLink": string,
  "emailAddress": string,
  "role": string,
  "allowFileDiscovery": boolean,
  "domain": string,
  "expirationTime": string,
  "deleted": boolean,
  "view": string,
  "pendingOwner": boolean,
  "inheritedPermissionsDisabled": boolean
}
फ़ील्ड
permissionDetails[]

object

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

string

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

  • file
  • member
permissionDetails[].inheritedFrom

string

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

string

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

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

ज़्यादा जानकारी के लिए, भूमिकाएं और अनुमतियां लेख पढ़ें.
permissionDetails[].inherited

boolean

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

string

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

string

सिर्फ़ आउटपुट के लिए. अनुमति की वैल्यू का "सुंदर" नाम. यहां हर तरह की अनुमति के उदाहरण दिए गए हैं:

  • user - उपयोगकर्ता का पूरा नाम, जैसा कि उसके Google खाते के लिए तय किया गया है. जैसे, "Dana A."
  • group - Google ग्रुप का नाम, जैसे कि "कंपनी के एडमिन."
  • domain - स्ट्रिंग डोमेन नेम, जैसे कि "cymbalgroup.com."
  • anyone - कोई displayName मौजूद नहीं है.
type

string

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

  • user
  • group
  • domain
  • anyone

अनुमति बनाते समय, अगर type user या group है, तो आपको उपयोगकर्ता या ग्रुप के लिए emailAddress देना होगा. अगर type domain है, तो आपको domain की जानकारी देनी होगी. अगर type, anyone है, तो कोई अतिरिक्त जानकारी देने की ज़रूरत नहीं है.
kind

string

सिर्फ़ आउटपुट के लिए. इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय की गई स्ट्रिंग "drive#permission".
emailAddress

string

उस उपयोगकर्ता या ग्रुप का ईमेल पता जिसे यह अनुमति दी गई है.
role

string

इस अनुमति से मिली भूमिका. इन वैल्यू का इस्तेमाल किया जा सकता है:

  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader

ज़्यादा जानकारी के लिए, भूमिकाएं और अनुमतियां लेख पढ़ें.
allowFileDiscovery

boolean

क्या इस अनुमति से, फ़ाइल को खोज के ज़रिए ढूंढा जा सकता है. यह सिर्फ़ domain या anyone टाइप की अनुमतियों पर लागू होता है.
domain

string

वह डोमेन जिससे यह अनुमति जुड़ी है.
expirationTime

string

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

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

boolean

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

string

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

published और metadata को वैल्यू के तौर पर इस्तेमाल किया जा सकता है:

  • published: अनुमति की भूमिका publishedReader है.
  • metadata: यह आइटम सिर्फ़ metadata व्यू में दिखता है, क्योंकि इसका ऐक्सेस सीमित है. साथ ही, स्कोप के पास पैरंट का कम से कम पढ़ने का ऐक्सेस है. metadata व्यू सिर्फ़ फ़ोल्डर के लिए उपलब्ध है.

ज़्यादा जानकारी के लिए, व्यू देखें.
pendingOwner

boolean

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

boolean

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

तरीके

create

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

delete

 यह अनुमति को मिटाता है.

get

 इस तरीके से, आईडी के हिसाब से अनुमति मिलती है.

list

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

update

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