CommentThread

يمثّل سلسلة محادثات تعليق واحدة داخل عرض تقديمي.

تمثيل JSON 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "plainTextQuote": string
  // End of mutually exclusive fields.
}
الحقول
commentId

string

المعرّف الفريد لسلسلة محادثات التعليق
anchorId

string

معرّف CommentAnchor في العرض التقديمي الذي ترتبط به سلسلة المحادثات هذه
headPost

object (Post)

المنشور الأول في سلسلة المحادثات
replies[]

object (Post)

الردود على المنشور الرئيسي
status

enum (Status)

ما إذا كانت سلسلة المحادثات مفتوحة أو تم حلّها
النص الذي تم اقتباسه من عنصر الصفحة عند إنشاء التعليق في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
plainTextQuote

string

النص الذي تم اقتباسه من عنصر الصفحة عند إنشاء التعليق، والذي تم تنسيقه كنص عادي
نهاية الحقول التي يستبعد كلّ منها الآخر

نشر

يمثّل منشورًا واحدًا في سلسلة محادثات تعليق.

تمثيل JSON 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedPresentation": boolean,
  "fromCopiedPresentation": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
الحقول
postId

string

النتائج فقط. المعرّف الفريد للمنشور
content

string

محتوى المنشور

يجب أن يكون هذا الحقل غير فارغ إذا لم يكن commentAction هو RESOLVE أو REOPEN.

سيتم التعامل مع هذا المحتوى النصي بشكل مشابه للتعليقات التي يتم إنشاؤها في "محرّر العروض التقديمية من Google". وسيكون له سلوكيات مشابهة للتنسيق والإشعارات وما إلى ذلك.

لا يمكن أن يتجاوز 2,048 وحدة ترميز UTF-8.
contentHtml

string

النتائج فقط. محتوى المنشور بتنسيق HTML
author

object (PostAuthor)

النتائج فقط. المستخدم الذي أنشأ المنشور
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء المنشور
updateTime

string (Timestamp format)

النتائج فقط. وقت آخر تعديل للمنشور
deleted

boolean

النتائج فقط. ما إذا تم حذف المنشور إذا كانت القيمة true، سيكون الحقلان content وauthor فارغَين.
fromImportedPresentation

boolean

النتائج فقط. ما إذا كان المنشور من عرض تقديمي تم استيراده لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
fromCopiedPresentation

boolean

النتائج فقط. ما إذا كان المنشور من عرض تقديمي تم نسخه لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
assigneeEmail

string

اختياريّ. البريد الإلكتروني للمستخدم الذي يتم تعيينه حديثًا لسلسلة المحادثات كجزء من هذا المنشور

يظهر الخطأ "400: طلب غير صالح" في الحالات التالية:

  • إذا كانت سلسلة المحادثات الرئيسية هي CommentThread لا يتضمّن headPost فيها مستلمًا

  • إذا تم تحديد commentAction على أنّه RESOLVE أو REOPEN

  • إذا تجاوز assigneeEmail عدد وحدات ترميز UTF-8 البالغ 2,048
commentAction

enum (CommentActionType)

الإجراء الذي تم اتخاذه كجزء من إنشاء المنشور

PostAuthor

يمثّل مستخدمًا أنشأ منشور تعليق.

تمثيل JSON 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
الحقول
displayName

string

اسم العرض الخاص بالمستخدم قد لا يكون متوفّرًا إذا كان المؤلّف مجهول الهوية.
me

boolean

ما إذا كان المستخدم هو المستخدم الذي تم التحقّق من هويته والذي يرسل الطلب
anonymous

boolean

ما إذا كان المستخدم مجهول الهوية
user

string

اسم مورد المستخدم الذي أنشأ المنشور، والذي يمكن استخدامه أيضًا لتحديد المستخدم في Google People API. التنسيق: users/{user} لن تتم تعبئة هذا الحقل إذا كانت قيمة الحقل `anonymous` هي true أو إذا كان المنشور من عرض تقديمي تم استيراده.

CommentActionType

الإجراء الذي تم اتخاذه مع هذا الردّ على سلسلة محادثات تعليق

عمليات التعداد
COMMENT_ACTION_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NO_COMMENT_ACTION_CHANGE لم يتم تغيير أي إجراء في هذا المنشور.
RESOLVE يؤدي هذا المنشور إلى حلّ سلسلة المحادثات.
REOPEN يؤدي هذا المنشور إلى إعادة فتح سلسلة المحادثات.

الحالة

خيارات حالة سلسلة محادثات التعليق

عمليات التعداد
STATUS_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
OPEN سلسلة محادثات التعليق مفتوحة.
RESOLVED تم حلّ سلسلة محادثات التعليق.