REST Resource: comments

משאב: תגובה

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

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

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

object (CommentReply)

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

string

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

string

פלט בלבד. הנתיב הזה תמיד drive#comment.
createdDate

string

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

string

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

string

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

string

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

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

string

אזור במסמך שמיוצג כמחרוזת JSON. פרטים על הגדרת מאפייני עוגן זמינים במאמר בנושא הוספת תגובות ותשובות.
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

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