- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- AccessProposal
- RoleAndView
- इसे आज़माएं!
किसी फ़ाइल पर AccessProposals की सूची बनाना. ध्यान दें: सिर्फ़ मंज़ूरी देने वाले लोग, फ़ाइल में ऐक्सेसप्रपोज़ल की सूची बना सकते हैं. अगर उपयोगकर्ता मंज़ूरी देने वाला नहीं है, तो 403 दिखाता है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
file |
ज़रूरी है. उस आइटम का आईडी जिस पर अनुरोध किया गया है. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
page |
ज़रूरी नहीं. ऐक्सेस के अनुरोधों की सूची में मौजूद, जारी रखने वाला टोकन. |
page |
ज़रूरी नहीं. हर पेज पर नतीजों की संख्या |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
ऐक्सेस के प्रस्ताव की सूची के लिए किए गए अनुरोध का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"accessProposals": [
{
object ( |
फ़ील्ड | |
---|---|
access |
पहुंच प्रस्तावों की सूची. यह फ़ील्ड सिर्फ़ v3 और v3beta में भरा जाता है. |
next |
नतीजों के अगले पेज के लिए, जारी रखने का टोकन. अगर नतीजों की सूची खत्म हो गई है, तो यह विकल्प नहीं दिखेगा. अगर टोकन किसी वजह से अस्वीकार हो जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से पेज नंबर डालना फिर से शुरू करना चाहिए. |
अनुमति के दायरे
इनमें से किसी एक 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 ( |
फ़ील्ड | |
---|---|
file |
वह फ़ाइल आईडी जिस पर ऐक्सेस के लिए प्रस्ताव चालू है |
proposal |
ऐक्सेस के प्रपोज़ल का आईडी |
requester |
अनुरोध करने वाले उपयोगकर्ता का ईमेल पता |
recipient |
उस उपयोगकर्ता का ईमेल पता जिसे अनुमतियां मिलेंगी |
roles |
ऐक्सेस प्रपोज़ल की भूमिका और व्यू के लिए रैपर. |
request |
प्रस्ताव में अनुरोध करने वाले व्यक्ति का जोड़ा गया मैसेज |
create |
बनाने का समय आरएफ़सी3339 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण के लिए: |
RoleAndView
ऐक्सेस प्रपोज़ल की भूमिका और व्यू के लिए रैपर.
JSON के काेड में दिखाना |
---|
{ "role": string, "view": string } |
फ़ील्ड | |
---|---|
role |
अनुरोध करने वाले व्यक्ति ने जो भूमिका सुझाई है आने वाले समय में नई वैल्यू जोड़ी जा सकती हैं. हालांकि, फ़िलहाल ये वैल्यू ही इस्तेमाल की जा सकती हैं: * |
view |
ऐक्सेस के इस प्रपोज़ल के व्यू को दिखाता है. सिर्फ़ उन प्रस्तावों के लिए पॉप्युलेट किया जाता है जो किसी व्यू से जुड़े होते हैं. सिर्फ़ |