REST Resource: comments

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

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

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

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

object (CommentReply)

النتائج فقط. الردود على هذه المشاركة
commentId

string

النتائج فقط. رقم تعريف التعليق
kind

string

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

string

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

string

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

string

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

string

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

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

string

منطقة في المستند يتم تمثيلها كسلسلة JSON. للحصول على تفاصيل حول تحديد سمات نقاط الارتكاز، يُرجى الرجوع إلى إضافة تعليقات وردود.
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

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