المرجع: تعليق
تعليق على ملف في Google Drive
تتطلب بعض طرق الموارد (مثل comments.update
) السمة commentId
. استخدِم الطريقة comments.list
لاسترداد المعرّف الخاص بتعليق في ملف.
تمثيل JSON |
---|
{ "commentId": string, "kind": string, "createdDate": string, "modifiedDate": string, "fileId": string, "status": string, "anchor": string, "replies": [ { object ( |
الحقول | |
---|---|
commentId |
النتائج فقط. رقم تعريف التعليق. |
kind |
النتائج فقط. دائمًا ما تكون هذه هي |
createdDate |
النتائج فقط. التاريخ الذي تم فيه إنشاء هذا التعليق لأول مرة. |
modifiedDate |
النتائج فقط. تاريخ آخر تعديل على هذا التعليق أو أي من الردود عليه. |
fileId |
النتائج فقط. الملف الذي يعالجه هذا التعليق. |
status |
النتائج فقط. حالة هذا التعليق. يمكن تغيير الحالة من خلال نشر ردّ على تعليق يتضمّن الحالة المطلوبة.
|
anchor |
منطقة من المستند ممثلة كسلسلة JSON. لمزيد من التفاصيل حول تحديد خصائص الارتساء، راجِع المقالة إضافة تعليقات وردود. |
replies[] |
النتائج فقط. الردود على هذه المشاركة. |
author |
النتائج فقط. تمثّل هذه السمة مؤلف التعليق. لن تتم تعبئة رقم تعريف الإذن وعنوان البريد الإلكتروني للمؤلف. |
deleted |
النتائج فقط. ما إذا تم حذف هذا التعليق. إذا تم حذف تعليق، فسيتم محو المحتوى وسيمثل هذا التعليق تعليقًا كان موجودًا من قبل فقط. |
selfLink |
النتائج فقط. رابط للرجوع إلى هذا التعليق |
htmlContent |
النتائج فقط. محتوى بتنسيق HTML لهذا التعليق |
content |
المحتوى النصي العادي الذي تم استخدامه لإنشاء هذا التعليق إنّ هذا القسم ليس آمنًا باستخدام HTML ويجب استخدامه فقط كنقطة بداية لإجراء تعديلات على محتوى التعليق. |
context |
سياق الملف الذي يتم التعليق عليه |
context.type |
نوع MIME لمقتطف السياق. |
context.value |
تمثيل بيانات مقطع الملف الذي يتم التعليق عليه في حالة وجود ملف نصي، على سبيل المثال، يكون هذا هو النص الفعلي الذي يدور حوله التعليق. |
fileTitle |
النتائج فقط. عنوان الملف الذي يعالجه هذا التعليق. |
الطُرق |
|
---|---|
|
يؤدي النقر على هذا الزر إلى حذف تعليق. |
|
يحصل على تعليق من خلال المعرّف. |
|
ينشئ تعليقًا جديدًا على الملف المحدّد. |
|
يعرض تعليقات ملف. |
|
لتعديل تعليق حالي. |
|
لتعديل تعليق حالي. |