- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह डायलॉग बॉक्स, किसी फ़ाइल या शेयर की गई ड्राइव की अनुमतियों की सूची बनाता है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
fileId |
फ़ाइल या शेयर की गई ड्राइव का आईडी. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
हर पेज पर दी जाने वाली अनुमतियों की ज़्यादा से ज़्यादा संख्या. अगर शेयर की गई ड्राइव में मौजूद फ़ाइलों के लिए यह नीति सेट नहीं की जाती है, तो ज़्यादा से ज़्यादा 100 नतीजे दिखाए जाएंगे. अगर 'शेयर की गई ड्राइव' में नहीं हैं, तो फ़ाइलों की पूरी सूची दिखेगी. |
pageToken |
अगले पेज पर सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले जवाब के 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए. |
supportsAllDrives |
अनुरोध किया गया ऐप्लिकेशन, 'मेरी ड्राइव' और 'शेयर की गई ड्राइव', दोनों के साथ काम करता है या नहीं. |
supportsTeamDrives |
अब सेवा में नहीं है: इसके बजाय |
useDomainAdminAccess |
डोमेन एडमिन के तौर पर अनुरोध करें. अगर इसे 'सही' पर सेट किया जाता है, तो अनुरोध करने वाले को ऐक्सेस मिल जाएगा. हालांकि, इसके लिए ज़रूरी है कि फ़ाइल आईडी पैरामीटर, 'शेयर की गई ड्राइव' के बारे में बताता हो और अनुरोध करने वाला व्यक्ति उस डोमेन का एडमिन हो जिससे 'शेयर की गई ड्राइव' जुड़ी है. |
includePermissionsForView |
इससे पता चलता है कि जवाब में कौनसे अतिरिक्त व्यू की अनुमतियां शामिल करनी हैं. सिर्फ़ 'पब्लिश की गई' साइट को ऐक्सेस किया जा सकता है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
किसी फ़ाइल के लिए अनुमतियों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"nextPageToken": string,
"kind": string,
"permissions": [
{
object ( |
फ़ील्ड | |
---|---|
nextPageToken |
अनुमतियों के अगले पेज के लिए पेज टोकन. अगर अनुमतियों की सूची, तय सीमा तक पहुंच जाती है, तो यह फ़ील्ड नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार किया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से ही पेज नंबर को फिर से शुरू करना चाहिए. पेज टोकन आम तौर पर कुछ घंटों के लिए मान्य रहता है. हालांकि, अगर नए आइटम जोड़े या हटाए जाते हैं, तो आपको अलग नतीजे मिल सकते हैं. |
kind |
यह बताता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग |
permissions[] |
अनुमतियों की सूची. अगर NextPageToken को पॉप्युलेट किया जाता है, तो यह सूची अधूरी हो सकती है. साथ ही, नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
अनुमति देने के दायरे
इनमें से कोई एक OAuth स्कोप ज़रूरी है:
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.photos.readonly
https://www.googleapis.com/auth/drive.readonly
कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.