Method: comments.list

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

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

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

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

पाथ पैरामीटर

पैरामीटर
fileId

string

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

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

पैरामीटर
includeDeleted

boolean

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

pageSize

integer

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

pageToken

string

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

startModifiedTime

string

'modifiedTime' का कम से कम मान देखें. (आरएफ़सी 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

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