Method: comments.list

किसी फ़ाइल की टिप्पणियों की सूची बनाता है.

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

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

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

पाथ के पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
includeDeleted

boolean

सेट किए जाने पर, सभी टिप्पणियां और जवाब दिखाए जाएंगे. इनमें मिटाई गई टिप्पणियां और जवाब (कॉन्टेंट हटाए जाने के साथ) भी शामिल हैं.
maxResults

integer

जवाब में शामिल की जाने वाली चर्चाओं की ज़्यादा से ज़्यादा संख्या, जिसका इस्तेमाल पेजिंग के लिए किया जाता है.
pageToken

string

कंटिन्यूशन टोकन, जिसका इस्तेमाल नतीजों के बड़े सेट में मौजूद पेजों के लिए किया जाता है. नतीजों का अगला पेज पाने के लिए, इस पैरामीटर को पिछले जवाब के "nextPageToken" की वैल्यू पर सेट करें.
updatedMin

string

सिर्फ़ उन बातचीत को दिखाया जाएगा जिन्हें इस टाइमस्टैंप के बाद अपडेट किया गया था. RFC 3339 टाइमस्टैंप के हिसाब से फ़ॉर्मैट किया गया.

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

यह हमेशा drive#commentList होता है.
items[]

object (Comment)

टिप्पणियों की सूची. अगर NextPageToken को पॉप्युलेट किया जाता है, तो यह सूची अधूरी हो सकती है. साथ ही, नतीजों का एक और पेज फ़ेच किया जाना चाहिए.
nextPageToken

string

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

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

इनमें से कोई एक 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

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