Method: comments.list

किसी फ़ाइल की टिप्पणियों की सूची बनाता है. ज़्यादा जानकारी के लिए, टिप्पणियां और जवाब मैनेज करना लेख पढ़ें.

ज़रूरी: fields पैरामीटर सेट होना चाहिए. अपनी ज़रूरत के हिसाब से फ़ील्ड दिखाने के लिए, खास फ़ील्ड दिखाना लेख पढ़ें.

एचटीटीपी अनुरोध

GET https://www.googleapis.com/drive/v3/files/{fileId}/comments

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

पाथ पैरामीटर

पैरामीटर
fileId

string

फ़ाइल का आईडी.

क्वेरी पैरामीटर

पैरामीटर
includeDeleted

boolean

मिटाई गई टिप्पणियों को शामिल करना है या नहीं. मिटाई गई टिप्पणियों में उनका मूल कॉन्टेंट शामिल नहीं होगा.
pageSize

integer

हर पेज पर टिप्पणियों की ज़्यादा से ज़्यादा संख्या.
pageToken

string

अगले पेज पर, सूची के पिछले अनुरोध को जारी रखने के लिए टोकन. इसे पिछले रिस्पॉन्स में मौजूद 'nextPageToken' की वैल्यू पर सेट किया जाना चाहिए.
startModifiedTime

string

नतीजों की टिप्पणियों के लिए, 'modifiedTime' की कम से कम वैल्यू (RFC 3339 तारीख-समय).

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

किसी फ़ाइल पर की गई टिप्पणियों की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह बताता है कि यह किस तरह का संसाधन है. वैल्यू: तय की गई स्ट्रिंग "drive#commentList".
comments[]

object (Comment)

टिप्पणियों की सूची. अगर nextPageToken की वैल्यू मौजूद है, तो हो सकता है कि यह सूची पूरी न हो. ऐसे में, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.
nextPageToken

string

टिप्पणियों के अगले पेज का पेज टोकन. अगर टिप्पणियों की सूची खत्म हो गई है, तो यह विकल्प नहीं दिखेगा. अगर किसी वजह से टोकन अस्वीकार कर दिया जाता है, तो उसे खारिज कर दिया जाना चाहिए. साथ ही, नतीजों के पहले पेज से पेजेशन को फिर से शुरू किया जाना चाहिए. आम तौर पर, पेज टोकन कई घंटों के लिए मान्य होता है. हालांकि, अगर नए आइटम जोड़े जाते हैं या हटाए जाते हैं, तो आपको मिलने वाले नतीजे अलग हो सकते हैं.

अनुमति के दायरे

इसके लिए, 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

कुछ स्कोप पर पाबंदी होती है. साथ ही, इनका इस्तेमाल करने के लिए आपके ऐप्लिकेशन को सुरक्षा से जुड़ी समीक्षा कराने की ज़रूरत होती है. ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.