Method: accessproposals.list

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

ध्यान दें: सिर्फ़ मंज़ूरी देने वाले लोग, किसी फ़ाइल पर ऐक्सेस के प्रस्तावों की सूची बना सकते हैं. अगर उपयोगकर्ता, अनुरोध स्वीकार करने वाला व्यक्ति नहीं है, तो 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)

ऐक्सेस के अनुरोधों की सूची. यह फ़ील्ड सिर्फ़ Drive API v3 में अपने-आप भरता है.
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

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