- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- कार्रवाई
- इसे आज़माएं!
इसका इस्तेमाल, ऐक्सेस के प्रस्ताव को स्वीकार या अस्वीकार करने के लिए किया जाता है.
एचटीटीपी अनुरोध
POST https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals/{proposalId}:resolve
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
fileId |
ज़रूरी है. उस आइटम का आईडी जिस पर अनुरोध किया गया है. |
proposalId |
ज़रूरी है. ऐक्सेस के उस प्रस्ताव का आईडी जिसे ठीक करना है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:
JSON के काेड में दिखाना |
---|
{
"role": [
string
],
"view": string,
"action": enum ( |
फ़ील्ड | |
---|---|
role[] |
ज़रूरी नहीं. अनुमति देने वाले व्यक्ति ने जो भूमिकाएं असाइन की हैं. ध्यान दें: |
view |
ज़रूरी नहीं. इस ऐक्सेस के प्रस्ताव के लिए व्यू दिखाता है. इसे सिर्फ़ तब सेट किया जाना चाहिए, जब प्रस्ताव किसी व्यू से जुड़ा हो. वैल्यू के तौर पर सिर्फ़ |
action |
ज़रूरी है. AccessProposal पर की जाने वाली कार्रवाई. |
sendNotification |
ज़रूरी नहीं. AccessProposal को अस्वीकार या स्वीकार किए जाने पर, अनुरोध करने वाले व्यक्ति को ईमेल भेजना है या नहीं. |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, तो जवाब का मुख्य हिस्सा खाली होता है.
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.
कार्रवाई
AccessProposal का स्टेटस बदलना.
Enums | |
---|---|
ACTION_UNSPECIFIED |
कोई कार्रवाई नहीं की गई |
ACCEPT |
उपयोगकर्ता, प्रस्ताव स्वीकार कर लेता है. ध्यान दें: अगर इस कार्रवाई का इस्तेमाल किया जाता है, तो role फ़ील्ड में कम से कम एक वैल्यू होनी चाहिए. |
DENY |
उपयोगकर्ता, प्रपोज़ल को अस्वीकार कर देता है |