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

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