בתיבת הדו-שיח הזו מפורטים התגובות בקובץ.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/files/{fileId}/comments
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
מזהה הקובץ. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
includeDeleted |
האם לכלול תגובות שנמחקו. תגובות שיימחקו לא יכללו את התוכן המקורי שלהן. |
pageSize |
מספר התגובות המרבי שיחזרו בכל דף. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. צריך להגדיר את הערך הזה לערך 'nextPageToken' מהתגובה הקודמת. |
startModifiedTime |
הערך המינימלי של 'modifiedTime' להערות לגבי התוצאות (RFC 3339 date-time). |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת תגובות בקובץ.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"comments": [
{
object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה |
comments[] |
רשימת התגובות. אם השדה nextPageToken מאוכלס, ייתכן שהרשימה הזו לא תהיה מלאה ויש לאחזר דף נוסף של תוצאות. |
nextPageToken |
אסימון הדף של דף התגובות הבא. אם רשימת התגובות תגיע לסוף רשימת התגובות, היא לא תופיע. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. אסימון הדף תקף בדרך כלל לכמה שעות. עם זאת, אם מוסיפים או מסירים פריטים חדשים, התוצאות הצפויות עשויות להיות שונות. |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.