Method: permissions.list

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
maxResults

integer

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

string

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

boolean

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

boolean

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

boolean

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

string

इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. वैल्यू के तौर पर, सिर्फ़ published को इस्तेमाल किया जा सकता है.

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
फ़ील्ड
nextPageToken

string

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

string

यह हमेशा drive#permissionList होता है.
etag

string

सूची का ETag.
items[]

object (Permission)

अनुमतियों की सूची.

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

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

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • 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

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