CommentThread

نشان‌دهنده‌ی یک رشته نظر (comment thread) واحد درون یک ارائه (presentation) است.

نمایش 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 نداشته باشد، لازم است خالی نباشد.

این محتوای متنی مشابه نظرات ایجاد شده در ویرایشگر اسلایدها مدیریت خواهد شد. رفتارهای مشابهی برای قالب‌بندی، اعلان‌ها و غیره خواهد داشت.

نباید از ۲۰۴۸ واحد کد 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

اختیاری. ایمیل کاربری که به تازگی به عنوان بخشی از این پست به تاپیک اختصاص داده شده است.

اگر موارد زیر رخ دهد، خطای درخواست نامناسب ۴۰۰ را برمی‌گرداند:

  • رشته والد، یک CommentThread است که headPost آن هیچ مسئولی ندارد.

  • commentAction به صورت RESOLVE یا REOPEN مشخص شده است.

  • assigneeEmail از 2048 واحد کد UTF-8 تجاوز می‌کند.

commentAction

enum ( CommentActionType )

اقدامی که به عنوان بخشی از ایجاد پست انجام شده است.

نویسنده پست

نشان دهنده کاربری است که یک پست نظر (کامنت) را نوشته است.

نمایش JSON
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
فیلدها
displayName

string

نام نمایشی کاربر. اگر نویسنده ناشناس باشد، ممکن است وجود نداشته باشد.

me

boolean

اینکه آیا کاربر، همان کاربر احراز هویت شده‌ای است که درخواست را ارسال می‌کند یا خیر.

anonymous

boolean

اینکه آیا کاربر ناشناس است یا خیر.

user

string

نام منبع کاربر نویسنده پست، که می‌تواند برای شناسایی کاربر در Google People API نیز استفاده شود. فرمت: users/{user} . اگر فیلد ناشناس برابر با true باشد یا اگر پست از یک ارائه وارد شده باشد، پر نخواهد شد.

نوع اقدام نظر

اقدامی که با این پاسخ به یک رشته نظر انجام شده است.

انوم‌ها
COMMENT_ACTION_TYPE_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
NO_COMMENT_ACTION_CHANGE هیچ تغییری در این پست اعمال نشده است.
RESOLVE این پست مشکل تاپیک رو حل میکنه.
REOPEN این پست باعث بازگشایی تاپیک میشه.

وضعیت

گزینه‌های وضعیت رشته نظرات.

انوم‌ها
STATUS_UNSPECIFIED مقدار پیش‌فرض. این مقدار استفاده نشده است.
OPEN تاپیک نظرات باز است.
RESOLVED مشکل تاپیک نظرات حل شد.