REST Resource: comments

משאב: תגובה

תגובה לקובץ ב-Google Drive.

ל-methods מסוימות של משאבים (כמו comments.update) נדרש commentId. כדי לאחזר את המזהה של תגובה בקובץ, משתמשים בשיטה comments.list.

ייצוג JSON
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
שדות
commentId

string

פלט בלבד. מזהה התגובה.

kind

string

פלט בלבד. הערך הוא תמיד drive#comment.

createdDate

string

פלט בלבד. התאריך שבו התגובה הזו נוצרה לראשונה.

modifiedDate

string

פלט בלבד. התאריך שבו בוצע השינוי האחרון של התגובה הזו או של תשובות אחרות אליה.

fileId

string

פלט בלבד. הקובץ שאליו מתייחסת התגובה הזו.

status

string

פלט בלבד. הסטטוס של התגובה הזו. אפשר לשנות את הסטטוס על ידי פרסום תשובה לתגובה עם הסטטוס הרצוי.

  • open – התגובה עדיין פתוחה.
  • resolved – התגובה טופלה על ידי אחת מהתשובות שלה.
anchor

string

אזור במסמך שמיוצג כמחרוזת JSON. לפרטים על הגדרת מאפייני עוגן, קראו את המאמר הוספת תגובות ותשובות.

replies[]

object (CommentReply)

פלט בלבד. תשובות לפוסט הזה.

author

object (User)

פלט בלבד. מחבר התגובה. כתובת האימייל ומזהה ההרשאה של המחבר לא יאוכלסו.

deleted

boolean

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

htmlContent

string

פלט בלבד. תוכן בפורמט HTML עבור התגובה הזו.

content

string

תוכן הטקסט הפשוט ששימש ליצירת התגובה הזו. קטע זה אינו בטוח לשימוש ב-HTML ויש להשתמש בו רק כנקודת התחלה לעריכת תוכן התגובה.

context

object

ההקשר של הקובץ שלגביו נשלחת התגובה.

context.type

string

סוג ה-MIME של קטע ההקשר.

context.value

string

ייצוג נתונים של הקטע בקובץ שרוצים להגיב עליו. אם מדובר בקובץ טקסט, למשל, זה יהיה הטקסט עצמו לגבי התגובה.

fileTitle

string

פלט בלבד. שם הקובץ שאליו מתייחסת התגובה הזו.

שיטות

delete

התגובה תימחק.

get

התגובה מקבלת תגובה לפי מזהה.

insert

יוצרת תגובה חדשה לקובץ הנתון.

list

בתיבת הדו-שיח הזו מפורטים התגובות בקובץ.

patch

מעדכנות תגובה קיימת.

update

מעדכנות תגובה קיימת.