Method: comments.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

מזהה הקובץ.

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

פרמטרים
includeDeleted

boolean

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

integer

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

string

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

string

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

גוף הבקשה

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

גוף התגובה

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

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

ייצוג 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.readonly

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