المرجع: تعليق
التعليق على ملف
تتطلب بعض طرق الموارد (مثل comments.update
) السمة commentId
. استخدِم الطريقة comments.list
لاسترداد المعرّف الخاص بتعليق في ملف.
تمثيل JSON |
---|
{ "id": string, "kind": string, "createdTime": string, "modifiedTime": string, "resolved": boolean, "anchor": string, "replies": [ { object ( |
الحقول | |
---|---|
id |
النتائج فقط. رقم تعريف التعليق. |
kind |
النتائج فقط. يحدد نوع هذا المورد. القيمة: السلسلة الثابتة |
createdTime |
النتائج فقط. وقت إنشاء التعليق (التاريخ والوقت لمعيار RFC 3339). |
modifiedTime |
النتائج فقط. تاريخ آخر تعديل على التعليق أو أي من ردوده (RFC 3339 date-time) |
resolved |
النتائج فقط. ما إذا كان قد تم حلّ التعليق من خلال أحد الردود عليه |
anchor |
منطقة من المستند ممثلة كسلسلة JSON. لمزيد من التفاصيل حول تحديد خصائص الارتساء، يمكنك الاطّلاع على المقالة إدارة التعليقات والردود. |
replies[] |
النتائج فقط. تمثّل هذه السمة القائمة الكاملة للردود على التعليق بترتيب زمني. |
author |
النتائج فقط. تمثّل هذه السمة مؤلف التعليق. لن تتم تعبئة رقم تعريف الإذن وعنوان البريد الإلكتروني للمؤلف. |
deleted |
النتائج فقط. ما إذا تم حذف التعليق. لا يحتوي التعليق المحذوف على أي محتوى. |
htmlContent |
النتائج فقط. محتوى التعليق بتنسيق HTML. |
content |
تمثّل هذه السمة محتوى النص العادي للتعليق. يُستخدم هذا الحقل لضبط المحتوى، بينما يجب عرض |
quotedFileContent |
محتوى الملف الذي يشير إليه التعليق، يكون عادةً داخل منطقة الارتساء. بالنسبة إلى الملف النصي، على سبيل المثال، يجب إدخال النص في مكان التعليق. |
quotedFileContent.mimeType |
نوع MIME للمحتوى المقتبَس |
quotedFileContent.value |
المحتوى المقتبس نفسه ويتم تفسير ذلك على أنّه نص عادي في حال ضبطه من خلال واجهة برمجة التطبيقات. |
الطُرق |
|
---|---|
|
ينشئ تعليقًا على ملف. |
|
يؤدي النقر على هذا الزر إلى حذف تعليق. |
|
يحصل على تعليق من خلال المعرّف. |
|
يعرض تعليقات ملف. |
|
يتم تعديل تعليق يتضمّن دلالات رمز التصحيح. |