REST Resource: comments

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

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

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

string

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

string

تكون القيمة دائمًا drive#comment.
createdDate

string

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

string

يشير هذا الحقل إلى تاريخ آخر مرة تم فيها تعديل هذا التعليق أو أي من ردوده.
fileId

string

الملف الذي يشير إليه هذا التعليق
fileTitle

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

تمثيل البيانات لجزء الملف الذي يتم التعليق عليه. في حالة ملف نصي مثلاً، سيكون هذا هو النص الفعلي الذي يتعلّق به التعليق.

الطُرق

delete

 يحذف هذا الإجراء تعليقًا.

get

 تعرض هذه الطريقة تعليقًا حسب رقم التعريف.

insert

 ينشئ تعليقًا جديدًا في الملف المحدّد.

list

 تعرض هذه الطريقة تعليقات ملف.

patch

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

update

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