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.

התוכן הזה יטופל באופן דומה לתגובות שנוצרו בכלי העריכה של Slides. ההתנהגות שלו תהיה דומה בכל הנוגע לעיצוב, להתראות וכו'.

הערך לא יכול לכלול יותר מ-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 חורג מ-2,048 יחידות קוד 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} השדה לא יאוכלס אם השדה anonymous הוא true או אם הפוסט הוא ממצגת שיובאה.

CommentActionType

הפעולה שבוצעה בתשובה הזו לשרשור תגובות.

טיפוסים בני מנייה (enum)
COMMENT_ACTION_TYPE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
NO_COMMENT_ACTION_CHANGE אין שינוי בפעולה בפוסט הזה.
RESOLVE הפוסט הזה פותר את הבעיה שמופיעה בשרשור.
REOPEN הפוסט הזה פותח מחדש את השרשור.

סטטוס

אפשרויות הסטטוס של שרשור התגובות.

טיפוסים בני מנייה (enum)
STATUS_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
OPEN שרשור התגובות פתוח.
RESOLVED הבעיה בשרשור התגובות נפתרה.