בתיבת הדו-שיח הזו מפורטים התגובות בקובץ.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
מזהה הקובץ. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
includeDeleted |
אם המדיניות מוגדרת, כל התגובות והתשובות, כולל תגובות שנמחקו ותשובות (לאחר הסרת התוכן), יוחזרו. |
maxResults |
מספר הדיונים המקסימלי שאפשר לכלול בתגובה, משמש לדפים. |
pageToken |
אסימון ההמשך, משמש למעבר בין קבוצות גדולות של תוצאות. כדי לקבל את דף התוצאות הבא, צריך להגדיר את הפרמטר הזה לערך של 'nextPageToken' מהתגובה הקודמת. |
updatedMin |
רק דיונים שעודכנו אחרי חותמת הזמן הזו יוחזרו. מעוצבת כחותמת זמן של RFC 3339. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת תגובות בקובץ ב-Google Drive.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
הערך הוא תמיד |
selfLink |
קישור בחזרה לרשימה זו. |
nextLink |
קישור לדף התגובות הבא. |
items[] |
רשימת התגובות. אם השדה nextPageToken מאוכלס, ייתכן שהרשימה הזו לא תהיה מלאה ויש לאחזר דף נוסף של תוצאות. |
nextPageToken |
אסימון הדף של דף התגובות הבא. אם רשימת התגובות תגיע לסוף רשימת התגובות, היא לא תופיע. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.