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

يعدّل تعليقًا يحتوي على دلالة رمزية.