בתיבת הדו-שיח הזו מפורטים התוויות בקובץ.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/listLabels
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
המזהה של הקובץ. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
המספר המקסימלי של תוויות שניתן להחזיר בכל דף. אם המדיניות לא מוגדרת, ברירת המחדל היא 100. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. צריך להגדיר אותו לערך |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת תוויות שהוחלו על קובץ.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"items": [
{
object ( |
שדות | |
---|---|
items[] |
רשימת התוויות. |
nextPageToken |
אסימון הדף של דף התוויות הבא. השדה הזה חסר אם הגעת לסוף הרשימה. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. |
kind |
הערך הוא תמיד |
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.