المرجع: تعليق
تعليق على ملف في 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 |
النتائج فقط. تمثّل هذه السمة عنوان الملف الذي يعالجه هذا التعليق. |
الطُرق |
|
---|---|
|
لحذف تعليق |
|
يحصل على تعليق باستخدام المعرّف. |
|
تنشئ تعليقًا جديدًا على الملف المحدد. |
|
يسرد تعليقات ملف. |
|
لتعديل تعليق حالي |
|
لتعديل تعليق حالي |