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.readonly

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