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

डोमेन एडमिन के तौर पर अनुरोध करें.

अगर इसे true पर सेट किया गया है और यहां दी गई अन्य शर्तें पूरी होती हैं, तो अनुरोध करने वाले व्यक्ति को ऐक्सेस दिया जाता है:

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

ज़्यादा जानकारी के लिए, डोमेन एडमिन के तौर पर शेयर की गई ड्राइव मैनेज करना लेख पढ़ें.
includePermissionsForView

string

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

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

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

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

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

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

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

object (Permission)

अनुमतियों की सूची. अगर nextPageToken की वैल्यू मौजूद है, तो हो सकता है कि यह सूची पूरी न हो. ऐसे में, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.
nextPageToken

string

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

string

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

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक 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

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