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

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

כדי לציין את התוויות שרוצים לאחזר, צריך להשתמש ב-method 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 של תווית שיש להחזיר. כדי לאתר את התוויות בקובץ, משתמשים ב-method files.listLabels.

הערות