Method: approvals.list

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

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

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

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

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