Method: approvals.list

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

ज़रूरी है. उस फ़ाइल का आईडी जिसके लिए मंज़ूरी दी गई है.

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

पैरामीटर
pageSize

integer

ज़्यादा से ज़्यादा कितनी अनुमतियां वापस लानी हैं. इसे सेट न करने पर, ज़्यादा से ज़्यादा 100 अनुमतियां वापस मिल जाती हैं.
pageToken

string

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

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

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

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

मंज़ूरी के अनुरोधों की सूची के अनुरोध का जवाब.

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "kind": string,
  "items": [
    {
      object (Approval)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह हमेशा drive#approvalList होता है
items[]

object (Approval)

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

string

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

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

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

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

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