החזרת תווית ממשאב קובץ

בדף הזה מוסבר איך להחזיר תוויות ספציפיות ממקור קובץ ב-Google Drive.

כדי לציין אילו תוויות רוצים לאחזר, משתמשים בשיטה files.get או בכל שיטה שמחזירה משאב קובץ. גוף הבקשה צריך להיות ריק.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של File.

דוגמה

דוגמת הקוד הבאה מראה איך להשתמש ב-fileId, בנוסף ל-labelId, כדי להחזיר את קבוצת התוויות הספציפיות. האובייקט includeLabels הוא רשימה של מזהים שמופרדים בפסיקים. האובייקט labelInfo בפרמטר fields מכיל תוויות שהוגדרו בקובץ ונכללו בבקשה בפרמטר includeLabels.

Java

File file = driveService.files().get("FILE_ID").setIncludeLabels("LABEL_ID,LABEL_ID").setFields("labelInfo").execute();

Python

file = drive_service.files().get(fileId="FILE_ID", includeLabels="LABEL_ID,LABEL_ID", fields="labelInfo").execute();

Node.js

/**
* Get a Drive file with specific labels
* @return{obj} file with labelInfo
**/
async function getFileWithSpecificLabels() {
  // 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 file = await service.files.get({
      fileId: 'FILE_ID',
      includeLabels: 'LABEL_ID,LABEL_ID',
      fields:'labelInfo',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }
}

מחליפים את מה שכתוב בשדות הבאים:

  • ‫FILE_ID: ה-fileId של הקובץ שמכיל את התוויות.
  • ‫LABEL_ID: ה-labelId של התווית שרוצים להחזיר. כדי לאתר את התוויות בקובץ, משתמשים בשיטה files.listLabels.

הערות