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

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