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 date-time)

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

يتم تعديل تعليق يتضمّن دلالات رمز التصحيح.