Method: comments.list

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

חובה: צריך להגדיר את הפרמטר fields. במאמר החזרת שדות ספציפיים מוסבר איך מחזירים את השדות הספציפיים שדרושים לכם.

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
includeDeleted

boolean

אם לכלול תגובות שנמחקו. תגובות שנמחקו לא יכללו את התוכן המקורי שלהן.
pageSize

integer

המספר המקסימלי של תגובות להצגה בכל דף.
pageToken

string

האסימון להמשך בקשת רשימה קודמת בדף הבא. צריך להגדיר את הערך הזה לערך של 'nextPageToken' מהתגובה הקודמת.
startModifiedTime

string

הערך המינימלי של 'modifiedTime' לתגובות על התוצאות (תאריך ושעה בפורמט RFC 3339).

גוף הבקשה

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

גוף התשובה

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

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

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

string

מזהה את סוג המשאב. ערך: המחרוזת הקבועה "drive#commentList".
comments[]

object (Comment)

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

string

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

היקפי הרשאה

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

  • 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

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