Method: files.listLabels

רשימת התוויות בקובץ. למידע נוסף, אפשר לקרוא את המאמר הצגת התוויות בקובץ.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

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

פרמטרים
fileId

string

המזהה של הקובץ.

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

פרמטרים
maxResults

integer

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

string

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

גוף הבקשה

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

גוף התשובה

רשימת התוויות שהוחלו על קובץ.

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

ייצוג ב-JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
שדות
labels[]

object (Label)

רשימת התוויות.
nextPageToken

string

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

string

הנתיב הזה תמיד "drive#labelList".

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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