- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
किसी फ़ाइल की टिप्पणियों की सूची बनाता है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
fileId |
फ़ाइल का आईडी. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
includeDeleted |
सेट किए जाने पर, सभी टिप्पणियां और जवाब दिखाए जाएंगे. इनमें मिटाई गई टिप्पणियां और जवाब (कॉन्टेंट हटाए जाने के साथ) भी शामिल हैं. |
maxResults |
जवाब में शामिल की जाने वाली चर्चाओं की ज़्यादा से ज़्यादा संख्या, जिसका इस्तेमाल पेजिंग के लिए किया जाता है. |
pageToken |
कंटिन्यूशन टोकन, जिसका इस्तेमाल नतीजों के बड़े सेट में मौजूद पेजों के लिए किया जाता है. नतीजों का अगला पेज पाने के लिए, इस पैरामीटर को पिछले जवाब के "nextPageToken" की वैल्यू पर सेट करें. |
updatedMin |
सिर्फ़ उन बातचीत को दिखाया जाएगा जिन्हें इस टाइमस्टैंप के बाद अपडेट किया गया था. RFC 3339 टाइमस्टैंप के हिसाब से फ़ॉर्मैट किया गया. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
Google Drive में किसी फ़ाइल पर की गई टिप्पणियों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"kind": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
फ़ील्ड | |
---|---|
kind |
यह हमेशा |
selfLink |
इस सूची पर वापस जाने के लिए लिंक. |
nextLink |
टिप्पणियों के अगले पेज का लिंक. |
items[] |
टिप्पणियों की सूची. अगर NextPageToken को पॉप्युलेट किया जाता है, तो यह सूची अधूरी हो सकती है. साथ ही, नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
nextPageToken |
टिप्पणियों के अगले पेज के लिए पेज टोकन. अगर टिप्पणियों की सूची खत्म हो गई है, तो यह विकल्प नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार किया जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से ही पेज नंबर को फिर से शुरू करना चाहिए. |
अनुमति देने के दायरे
इनमें से कोई एक 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.readonly
कुछ दायरे सीमित हैं. इनका इस्तेमाल करने के लिए, सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.