REST Resource: comments

المورد: تعليق

تعليق على ملف

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

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

object (Reply)

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

string

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

string

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

string

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

string

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

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا تم حلّ التعليق من خلال أحد الردود عليه.
anchor

string

منطقة في المستند يتم تمثيلها كسلسلة JSON. للحصول على تفاصيل حول تحديد سمات عناصر الربط، يُرجى الرجوع إلى إدارة التعليقات والردود.
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

 تعدّل هذه الطريقة تعليقًا باستخدام دلالات التصحيح.