Method: comments.list

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

בקשת HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/comments

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
fileId

string

המזהה של הקובץ.

פרמטרים של שאילתה

פרמטרים
includeDeleted

boolean

אם הערך מוגדר, כל התגובות והתשובות, כולל תגובות ותשובות שנמחקו (עם תוכן שהוסר), יוחזרו.
maxResults

integer

המספר המקסימלי של דיונים שייכללו בתשובה, לשימוש בעימוד.
pageToken

string

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

string

יוחזרו רק דיונים שעודכנו אחרי חותמת הזמן הזו. הפורמט הוא חותמת זמן RFC 3339.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

רשימה של תגובות על קובץ ב-Google Drive.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "items": [
    {
      object (Comment)
    }
  ],
  "kind": string,
  "selfLink": string,
  "nextLink": string,
  "nextPageToken": string
}
שדות
items[]

object (Comment)

רשימת התגובות. אם השדה nextPageToken מאוכלס, יכול להיות שהרשימה הזו לא מלאה וצריך לאחזר דף נוסף של תוצאות.
kind

string

הנתיב הזה תמיד drive#commentList.
nextPageToken

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

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