REST Resource: comments

משאב: תגובה

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

כדי להשתמש בחלק מהשיטות של המשאבים (כמו 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

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

Methods

delete

מחיקת תגובה.

get

אחזור תגובה לפי מזהה.

insert

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

list

הצגת רשימה של התגובות לקובץ.

patch

עדכון של תגובה קיימת.

update

עדכון של תגובה קיימת.