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

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

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

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