Method: files.listLabels

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
maxResults

integer

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

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

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