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

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