Method: permissions.list

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

एचटीटीपी अनुरोध

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
fileId

string

फ़ाइल या शेयर की गई ड्राइव का आईडी.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

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

string

अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए .
supportsAllDrives

boolean

अनुरोध करने वाला ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं.
supportsTeamDrives
(deprecated)

boolean

अब काम नहीं करता: इसके बजाय, supportsAllDrives का इस्तेमाल करें.
useDomainAdminAccess

boolean

डोमेन एडमिन के तौर पर अनुरोध जारी करें; अगर इसे 'सही है' पर सेट किया जाता है, तो अनुरोध करने वाले व्यक्ति को ऐक्सेस दिया जाएगा. ऐसा तब होगा, जब फ़ाइल आईडी पैरामीटर किसी 'शेयर की गई ड्राइव' का हिस्सा हो और अनुरोध करने वाला व्यक्ति, उस डोमेन का एडमिन हो जिससे 'शेयर की गई ड्राइव' जुड़ी है.
includePermissionsForView

string

इससे पता चलता है कि रिस्पॉन्स में किस अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश किया गया' समर्थित है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

किसी फ़ाइल के लिए अनुमतियों की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
फ़ील्ड
nextPageToken

string

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

string

इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग "drive#permissionList".
permissions[]

object (Permission)

अनुमतियों की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए.

अनुमति के दायरे

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

कुछ दायरे पर पाबंदी है. इनका इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.