CommentThread

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

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

  "plainTextQuote": string
}
الحقول
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 2048 وحدة رمز UTF-8.
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} لن تتم تعبئة هذا الحقل إذا كان الحقل المجهول الهوية true أو إذا كانت المشاركة من عرض تقديمي تم استيراده.

CommentActionType

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

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

الحالة

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

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