Method: files.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

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

AccessProposal

फ़ाइल पर उपलब्ध पहुंच प्रस्तावों के लिए पहुंच प्रस्ताव संसाधन

JSON के काेड में दिखाना
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
फ़ील्ड
fileId

string

वह फ़ाइल आईडी जिस पर ऐक्सेस के लिए प्रस्ताव चालू है

proposalId

string

ऐक्सेस के प्रपोज़ल का आईडी

requesterEmailAddress

string

अनुरोध करने वाले उपयोगकर्ता का ईमेल पता

recipientEmailAddress

string

उस उपयोगकर्ता का ईमेल पता जिसे अनुमतियां मिलेंगी

rolesAndViews[]

object (RoleAndView)

ऐक्सेस प्रपोज़ल की भूमिका और व्यू के लिए रैपर.

requestMessage

string

प्रस्ताव में अनुरोध करने वाले व्यक्ति का जोड़ा गया मैसेज

createTime

string (Timestamp format)

बनाने का समय

आरएफ़सी3339 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

RoleAndView

ऐक्सेस प्रपोज़ल की भूमिका और व्यू के लिए रैपर.

JSON के काेड में दिखाना
{
  "role": string,
  "view": string
}
फ़ील्ड
role

string

अनुरोध करने वाले व्यक्ति ने जो भूमिका सुझाई है आने वाले समय में नई वैल्यू जोड़ी जा सकती हैं. हालांकि, फ़िलहाल ये वैल्यू ही इस्तेमाल की जा सकती हैं: * writer * commenter * reader

view

string

ऐक्सेस के इस प्रपोज़ल के व्यू को दिखाता है. सिर्फ़ उन प्रस्तावों के लिए पॉप्युलेट किया जाता है जो किसी व्यू से जुड़े होते हैं. सिर्फ़ published वैल्यू इस्तेमाल की जा सकती है.