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

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