REST Resource: comments

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

تعليق على ملف في Google Drive

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

تمثيل JSON 
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
الحقول
commentId

string

الإخراج فقط. رقم تعريف التعليق.
kind

string

الإخراج فقط. وتكون هذه القيمة هي "drive#comment" دائمًا.
createdDate

string

الإخراج فقط. التاريخ الذي تم فيه إنشاء هذا التعليق لأول مرة.
modifiedDate

string

الإخراج فقط. التاريخ الذي تم فيه آخر تعديل لهذا التعليق أو أي من ردوده.
fileId

string

الإخراج فقط. الملف الذي يتناوله هذا التعليق
status

string

الإخراج فقط. حالة هذا التعليق. يمكن تغيير الحالة من خلال نشر ردّ على تعليق بالحالة المطلوبة.

  • open - لا يزال التعليق مفتوحًا.
  • resolved: تم حلّ التعليق من خلال أحد ردوده.
anchor

string

منطقة من المستند المُمثَّلة كسلسلة JSON. للحصول على تفاصيل عن تحديد خصائص الإرساء، ارجع إلى إضافة التعليقات والردود.
replies[]

object (CommentReply)

الإخراج فقط. الردّ على هذه المشاركة
author

object (User)

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

boolean

الإخراج فقط. ما إذا تم حذف هذا التعليق. إذا تم حذف تعليق، سيتم محو المحتوى وسيمثّل هذا التعليق تعليقًا كان متاحًا فقط.
htmlContent

string

الإخراج فقط. محتوى بتنسيق HTML لهذا التعليق
content

string

محتوى النص العادي المُستخدَم لإنشاء هذا التعليق هذه الإعدادات غير آمنة بتنسيق HTML، ويجب استخدامها فقط كنقطة بداية لإجراء تعديلات على محتوى تعليق.
context

object

سياق الملف الذي يتم التعليق عليه.
context.type

string

نوع MIME لمقتطف السياق.
context.value

string

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

string

الإخراج فقط. تمثّل هذه السمة عنوان الملف الذي يتناوله هذا التعليق.

الطُرق

delete

 حذف تعليق

get

 الحصول على تعليق حسب رقم التعريف

insert

 يتم إنشاء تعليق جديد على الملف المحدّد.

list

 يعرض تعليقات ملف.

patch

 تعديل تعليق حالي

update

 تعديل تعليق حالي