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

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

כדי להציג את רשימת תוויות הקובץ, משתמשים ב-method‏ files.listLabels. גוף הבקשה חייב להיות ריק. השיטה מקבלת גם את פרמטר השאילתה האופציונלי maxResults כדי להגדיר את המספר המקסימלי של תוויות להחזרה בכל דף. אם לא מגדירים את הפרמטר, מוחזר מספר התוצאות שמוגדר כברירת מחדל – 100.

אם הפעולה בוצעה בהצלחה, גוף התגובה יכיל את רשימת התוויות שהוחלו על הקובץ. הם נמצאים באובייקט items מסוג Label.

דוגמה

דוגמת הקוד הבאה מראה איך להשתמש ב-fileId של התווית כדי לאחזר את התוויות הנכונות.

Java

List<Label> labelList =
labelsDriveClient.files().listLabels("FILE_ID").execute().getItems();

Python

label_list_response = drive_service.files().listLabels(fileId="FILE_ID").execute();

Node.js

/**
* Lists all the labels on a Drive file
* @return{obj} a list of Labels
**/
async function listLabels() {
  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app

  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  const auth = new GoogleAuth({scopes: 'https://www.googleapis.com/auth/drive'});
  const service = google.drive({version: 'v3', auth});
  try {
    const labelListResponse = await service.files.listLabels({
      fileId: 'FILE_ID',
    });
    return labelListResponse;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

מחליפים את FILE_ID ב-fileId של הקובץ שרוצים לקבל את רשימת התוויות שלו.