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

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

שיטות

delete

 מוחק תגובה.

get

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

insert

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

list

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

patch

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

update

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