المرجع: تعليق
تعليق على ملف.
تتطلّب بعض طُرق الموارد (مثل 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). |
resolved |
النتائج فقط. ما إذا تم حلّ التعليق بواسطة أحد الردود عليه |
anchor |
يشير ذلك المصطلح إلى منطقة من المستند يتم تمثيلها كسلسلة JSON. للحصول على تفاصيل عن تحديد خصائص الارتساء، يمكنك الرجوع إلى إدارة التعليقات والردود. |
replies[] |
النتائج فقط. تعرض القائمة الكاملة للردود على التعليق بالترتيب الزمني. |
author |
النتائج فقط. تمثّل هذه السمة مؤلف التعليق. لن تتم تعبئة عنوان البريد الإلكتروني للمؤلف ومعرّف الإذن. |
deleted |
النتائج فقط. ما إذا كان قد تم حذف التعليق أم لا. لا يتضمّن التعليق المحذوف أي محتوى. |
htmlContent |
النتائج فقط. محتوى التعليق بتنسيق HTML. |
content |
محتوى النص العادي للتعليق. يُستخدم هذا الحقل لإعداد المحتوى، بينما يجب عرض |
quotedFileContent |
محتوى الملف الذي يشير إليه التعليق، عادةً داخل منطقة الارتساء. بالنسبة إلى الملف النصي، على سبيل المثال، سيكون هذا هو النص في موقع التعليق. |
quotedFileContent.mimeType |
تمثّل هذه السمة نوع MIME للمحتوى المقتبَس. |
quotedFileContent.value |
المحتوى المقتبَس نفسه يُفسر هذا على أنه نص عادي إذا تم ضبطه من خلال واجهة برمجة التطبيقات. |
الطُرق |
|
---|---|
|
لإنشاء تعليق على ملف |
|
لحذف تعليق |
|
يحصل على تعليق باستخدام المعرّف. |
|
يسرد تعليقات ملف. |
|
يحدّث التعليق باستخدام دلالات رموز التصحيح. |