חיפוש קבצים עם תווית או ערך שדה ספציפיים

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

סוגי שדות התוויות

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

סוג אפשרויות לסוג התווית אופרטורים נתמכים לחיפוש
טקסט TextOptions is null, is not null, =, contains, starts with
טקסט ארוך LongTextOptions is null, is not null, contains
מספר שלם IntegerOptions is null, is not null, =, !=, <, >, <=, >=
תאריך DateOptions is null, is not null, =, !=, <, >, <=, >=
בחירה SelectionOptions is null, is not null, =, !=
משתמש UserOptions is null, is not null, =, !=
רשימת הבחירה ‫SelectionOptions (עם max_entries > 1) is null, is not null, in, not in
רשימת משתמשים UserOptions (עם max_entries > 1) is null, is not null, in, not in

1. חיפוש לפי נוכחות של תווית או שדה

אפשר לחפש פריטים שתווית מסוימת הוחלה עליהם (או לא הוחלה עליהם):

  • 'labels/contract' in labels
  • not 'labels/contract' in labels

אפשר גם לחפש פריטים שבהם שדה מסוים הוגדר (או לא הוגדר):

  • labels/contract.comment IS NOT NULL
  • labels/contract.comment IS NULL

2. חיפוש שמבוסס על שדות עם ערך יחיד

אפשר לכתוב שאילתות חיפוש כדי להתאים לערכי שדות צפויים. בטבלה הבאה מפורטות שאילתות השדות התקינות:

מה רוצים לשאול מחרוזת שאילתה
פריטים שבהם התגובה מוגדרת כ-'hello' labels/contract.comment = 'hello'
קבצים שבהם התגובה מתחילה במילה hello labels/contract.comment STARTS WITH 'hello'
קבצים שבהם מופעל סטטוס labels/contract.status = 'executed'
קבצים שהסטטוס שלהם הוא לא בוצע labels/contract.status != 'executed'
קבצים שבהם הערך של execution_date הוא לפני תאריך ספציפי labels/contract.execution_date < '2020-06-22'
קבצים שבהם הערך value_usd (מספר שלם) קטן מערך ספציפי labels/contract.value_usd < 2000
קבצים שבהם client_contact מוגדר לכתובת אימייל ספציפית labels/contract.client_contact = 'alex@altostrat.com'

3. חיפוש על סמך שדות עם שדות מרובי ערכים (כמו ListOptions.max_entries > 1)

אפשר להריץ שאילתות על שדות שתומכים בכמה ערכים רק באמצעות האופרטור IN:

  • 'EMAIL_ADDRESS' IN labels/project.project_leads
  • NOT 'EMAIL_ADDRESS' IN labels/project.project_leads

דוגמה

בדוגמת הקוד הבאה אפשר לראות איך משתמשים באחד או יותר מסימני labelId כדי להציג רשימה של כל הקבצים עם תווית ספציפית או ערך שדה ספציפי ממשאב של קובץ ב-Drive. היא משתמשת גם בשיטה files.list. גוף הבקשה צריך להיות ריק.

אם רוצים לכלול את labelInfo בתשובה, צריך לציין גם את הפרטים הבאים:

  • includeLabels כרשימה של מזהים מופרדים בפסיקים.

  • ‫labelInfo בפרמטר fields כדי לציין שרוצים שהערך labelInfo יוחזר בתוך includeLabels.

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

Java

List<File> fileList = driveService.files().list().setIncludeLabels("LABEL_1_ID,LABEL_2_ID").setFields("items(labelInfo, id)").setQ("'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels").execute().getItems();

Python

file_list = drive_service.files().list(includeLabels="LABEL_1_ID,LABEL_2_ID", q="'labels/LABEL_1_ID' in labels and 'labels/LABEL_2_ID' in labels", fields="items(labelInfo, id)").execute();

Node.js

/**
* Search for Drive files with specific labels
* @return{obj} file list with labelInfo
**/
async function searchForFileWithLabels() {
  // 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 fileList = await service.files.list({
      includeLabels: 'LABEL_1_ID,LABEL_2_ID',
      q: '\'labels/LABEL_1_ID\' in labels and \'labels/LABEL_2_ID\' in labels',
      fields:'files(labelInfo, id)',
    });
    return file;
  } catch (err) {
    // TODO (developer) - Handle error
    throw err;
  }

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

  • ‫LABEL_1_ID: התווית הראשונה שרוצים להחזיר.labelId
  • ‫LABEL_2_ID: התווית השנייה labelId שרוצים להחזיר.