REST Resource: comments

संसाधन: टिप्पणी

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

संसाधन के कुछ तरीकों (जैसे कि comments.update) के लिए, commentId की ज़रूरत होती है. किसी फ़ाइल में मौजूद टिप्पणी का आईडी वापस पाने के लिए, comments.list तरीके का इस्तेमाल करें.

JSON के काेड में दिखाना
{
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
फ़ील्ड
replies[]

object (CommentReply)

सिर्फ़ आउटपुट के लिए. इस पोस्ट के जवाब.

commentId

string

सिर्फ़ आउटपुट के लिए. टिप्पणी का आईडी.

kind

string

सिर्फ़ आउटपुट के लिए. यह हमेशा drive#comment होता है.

createdDate

string

सिर्फ़ आउटपुट के लिए. वह तारीख जब यह टिप्पणी पहली बार की गई थी.

modifiedDate

string

सिर्फ़ आउटपुट के लिए. वह तारीख, जब इस टिप्पणी या इसके किसी जवाब में पिछली बार बदलाव किया गया था.

fileId

string

सिर्फ़ आउटपुट के लिए. वह फ़ाइल जिसके बारे में यह टिप्पणी की गई है.

status

string

सिर्फ़ आउटपुट के लिए. इस टिप्पणी की स्थिति. टिप्पणी का जवाब पोस्ट करके, उसकी स्थिति बदली जा सकती है.

  • open - टिप्पणी अब भी खुली है.
  • resolved - टिप्पणी को उसके किसी जवाब से हल कर दिया गया है.
anchor

string

दस्तावेज़ का एक हिस्सा, जिसे JSON स्ट्रिंग के तौर पर दिखाया गया है. ऐंकर प्रॉपर्टी तय करने के बारे में ज़्यादा जानने के लिए, टिप्पणियां और जवाब जोड़ना लेख पढ़ें.

author

object (User)

सिर्फ़ आउटपुट के लिए. टिप्पणी करने वाला व्यक्ति. लेखक का ईमेल पता और अनुमति आईडी नहीं भरा जाएगा.

deleted

boolean

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

htmlContent

string

सिर्फ़ आउटपुट के लिए. इस टिप्पणी के लिए एचटीएमएल फ़ॉर्मैट किया गया कॉन्टेंट.

content

string

इस टिप्पणी को बनाने के लिए इस्तेमाल किया गया सादा टेक्स्ट कॉन्टेंट. यह एचटीएमएल के लिए सुरक्षित नहीं है. इसका इस्तेमाल सिर्फ़ टिप्पणी के कॉन्टेंट में बदलाव करने के लिए किया जाना चाहिए.

context

object

उस फ़ाइल का कॉन्टेक्स्ट जिस पर टिप्पणी की जा रही है.

context.type

string

कॉन्टेक्स्ट स्निपेट का MIME टाइप.

context.value

string

जिस फ़ाइल के सेगमेंट पर टिप्पणी की जा रही है उसका डेटा. उदाहरण के लिए, टेक्स्ट फ़ाइल के मामले में, यह वह असल टेक्स्ट होगा जिसके बारे में टिप्पणी की गई है.

fileTitle

string

सिर्फ़ आउटपुट के लिए. उस फ़ाइल का टाइटल जिस पर यह टिप्पणी की गई है.

तरीके

delete

किसी टिप्पणी को मिटाता है.

get

आईडी के हिसाब से टिप्पणी फ़ेच करता है.

insert

इससे दी गई फ़ाइल पर नई टिप्पणी की जाती है.

list

किसी फ़ाइल में की गई टिप्पणियों की सूची दिखाता है.

patch

इस तरीके का इस्तेमाल करके, किसी मौजूदा टिप्पणी को अपडेट किया जा सकता है.

update

इस तरीके का इस्तेमाल करके, किसी मौजूदा टिप्पणी को अपडेट किया जा सकता है.