Method: accessproposals.list

किसी फ़ाइल पर AccessProposals की सूची बनाना. ध्यान दें: सिर्फ़ अनुमति देने वाले लोग, किसी फ़ाइल पर ऐक्सेस के प्रस्तावों की सूची बना सकते हैं. अगर उपयोगकर्ता अनुमति देने वाला व्यक्ति नहीं है, तो 403 कोड दिखाता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

ज़रूरी है. उस आइटम का आईडी जिस पर अनुरोध किया गया है.

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

पैरामीटर
pageToken

string

ज़रूरी नहीं. ऐक्सेस के अनुरोधों की सूची में मौजूद, जारी रखने वाला टोकन.
pageSize

integer

ज़रूरी नहीं. हर पेज पर नतीजों की संख्या

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

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

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

ऐक्सेस के प्रस्ताव की सूची के अनुरोध का जवाब.

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

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

object (AccessProposal)

ऐक्सेस के अनुरोधों की सूची. यह फ़ील्ड सिर्फ़ v3 और v3beta में पॉप्युलेट होता है.
nextPageToken

string

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

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

इसके लिए, 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.readonly

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