- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
फ़ाइल की टिप्पणियों की सूची बनाता है.
एचटीटीपी अनुरोध
GET https://www.googleapis.com/drive/v3/files/{fileId}/comments
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
fileId |
फ़ाइल का आईडी. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
includeDeleted |
क्या मिटाई गई टिप्पणियों को शामिल करना है. मिटाई गई टिप्पणियों में उनका ओरिजनल कॉन्टेंट शामिल नहीं होगा. |
pageSize |
हर पेज पर दी जाने वाली टिप्पणियों की ज़्यादा से ज़्यादा संख्या. |
pageToken |
अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए . |
startModifiedTime |
'modifiedTime' का कम से कम मान देखें. (आरएफ़सी 3339 तारीख-समय). |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
किसी फ़ाइल पर मौजूद टिप्पणियों की सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"kind": string,
"comments": [
{
object ( |
फ़ील्ड | |
---|---|
kind |
इससे पता चलता है कि यह किस तरह का संसाधन है. वैल्यू: तय स्ट्रिंग |
comments[] |
टिप्पणियों की सूची. अगर NextPageToken में जानकारी अपने-आप भर जाती है, तो हो सकता है कि यह सूची अधूरी हो और नतीजों का एक और पेज फ़ेच किया जाना चाहिए. |
nextPageToken |
टिप्पणियों के अगले पेज के लिए पेज टोकन. अगर टिप्पणियों की सूची खत्म हो जाती है, तो यह नहीं दिखेगा. अगर टोकन किसी वजह से अस्वीकार हो जाता है, तो उसे खारिज कर देना चाहिए. साथ ही, नतीजों के पहले पेज से पेज नंबर डालना फिर से शुरू करना चाहिए. आम तौर पर, पेज टोकन कई घंटों के लिए मान्य होता है. हालांकि, अगर नए आइटम जोड़े या हटाए जाते हैं, तो आपको अलग तरह के नतीजे दिख सकते हैं. |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.readonly
कुछ दायरे पर पाबंदी है. इनका इस्तेमाल करने के लिए, आपके ऐप्लिकेशन को सुरक्षा जांच की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.