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

تعديل تعليق باستخدام دلالات التصحيح