Method: comments.list

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
fileId

string

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

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

פרמטרים
includeDeleted

boolean

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

integer

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

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

string

הערך הוא תמיד drive#commentList.
items[]

object (Comment)

רשימת התגובות. אם nextPageToken מאוכלס, יכול להיות שהרשימה הזו חלקית וצריך לאחזר דף נוסף של תוצאות.
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

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