REST Resource: comments

المرجع: تعليق

تعليق على ملف.

تتطلّب بعض طُرق الموارد (مثل comments.update) السمة commentId. استخدِم الطريقة comments.list لاسترداد رقم التعريف الخاص بتعليق في ملف.

تمثيل JSON
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
الحقول
id

string

النتائج فقط. رقم تعريف التعليق.

kind

string

النتائج فقط. تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#comment".

createdTime

string

النتائج فقط. الوقت الذي تم فيه إنشاء التعليق (التاريخ-الوقت RFC 3339).

modifiedTime

string

النتائج فقط. آخر مرة تم فيها تعديل التعليق أو أي من الردود عليه (التاريخ والوقت وفقًا لمعيار RFC 3339).

resolved

boolean

النتائج فقط. ما إذا تم حلّ التعليق بواسطة أحد الردود عليه

anchor

string

يشير ذلك المصطلح إلى منطقة من المستند يتم تمثيلها كسلسلة JSON. للحصول على تفاصيل عن تحديد خصائص الارتساء، يمكنك الرجوع إلى إدارة التعليقات والردود.

replies[]

object (Reply)

النتائج فقط. تعرض القائمة الكاملة للردود على التعليق بالترتيب الزمني.

author

object (User)

النتائج فقط. تمثّل هذه السمة مؤلف التعليق. لن تتم تعبئة عنوان البريد الإلكتروني للمؤلف ومعرّف الإذن.

deleted

boolean

النتائج فقط. ما إذا كان قد تم حذف التعليق أم لا. لا يتضمّن التعليق المحذوف أي محتوى.

htmlContent

string

النتائج فقط. محتوى التعليق بتنسيق HTML.

content

string

محتوى النص العادي للتعليق. يُستخدم هذا الحقل لإعداد المحتوى، بينما يجب عرض htmlContent.

quotedFileContent

object

محتوى الملف الذي يشير إليه التعليق، عادةً داخل منطقة الارتساء. بالنسبة إلى الملف النصي، على سبيل المثال، سيكون هذا هو النص في موقع التعليق.

quotedFileContent.mimeType

string

تمثّل هذه السمة نوع MIME للمحتوى المقتبَس.

quotedFileContent.value

string

المحتوى المقتبَس نفسه يُفسر هذا على أنه نص عادي إذا تم ضبطه من خلال واجهة برمجة التطبيقات.

الطُرق

create

لإنشاء تعليق على ملف

delete

لحذف تعليق

get

يحصل على تعليق باستخدام المعرّف.

list

يسرد تعليقات ملف.

update

يحدّث التعليق باستخدام دلالات رموز التصحيح.