Method: files.listLabels

מפרט את התוויות בקובץ.

בקשת HTTP

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

כתובת ה-URL כוללת תחביר של קידוד gRPC.

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

פרמטרים
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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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