Google Drive API תומך במספר דרכים לחיפוש קבצים ותיקיות.
אפשר להשתמש בשיטה files.list
כדי להחזיר
כל הקבצים והתיקיות של המשתמש ב-Drive או חלק מהם. files.list
אפשר להשתמש ב-method גם כדי לאחזר את ה-fileId
שנדרש במשאב מסוים
שיטות (כמו files.get
files.update
).
חיפוש כל הקבצים והתיקיות בתיקיית 'האחסון שלי' של המשתמש הנוכחי
משתמשים בשיטה files.list
ללא פרמטרים כדי להחזיר את כל הקבצים
תיקיות.
GET https://www.googleapis.com/drive/v3/files
חיפוש קבצים או תיקיות ספציפיים בתיקיית 'האחסון שלי' של המשתמש הנוכחי
כדי לחפש קבוצה ספציפית של קבצים או תיקיות, צריך להשתמש בשדה q
במחרוזת השאילתה
באמצעות השיטה files.list
כדי לסנן את
קבצים להחזרה על ידי שילוב של מונח חיפוש אחד או יותר.
מחרוזת שאילתה מכילה את שלושת החלקים הבאים:
query_term operator values
כאשר:
query_term
הוא מונח השאילתה או השדה לחיפוש.השדה
operator
מציין את התנאי של מונח השאילתה.values
הם הערכים הספציפיים שרוצים להשתמש בהם לסינון החיפוש תוצאות.
כדי להציג את המונחים והאופרטורים של השאילתות שאפשר להשתמש בהם לסינון קבצים ותיקיות, כדאי לעיין בקטע מונחים ואופרטורים של שאילתות חיפוש.
לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כדי להחזיר רק תיקיות באמצעות הגדרה של סוג MIME:
q: mimeType = 'application/vnd.google-apps.folder'
מידע נוסף על סוגי MIME זמין במאמר Google Workspace ו-Google Drive סוגי MIME נתמכים.
דוגמאות למחרוזות שאילתות
הטבלה הבאה מפרטת דוגמאות לכמה מחרוזות שאילתה בסיסיות. הקוד עצמו משתנה בהתאם לספריית הלקוח שבה אתם משתמשים לחיפוש.
בנוסף, צריך לסמן בתו בריחה (escape) תווים מיוחדים בשמות הקבצים כדי לוודא
שהשאילתה פועלת כמו שצריך. לדוגמה, אם שם קובץ מכיל גרש
('
) ותו לוכסן הפוך ("\"
), צריך להשתמש בקו נטוי שמאלה כדי לסמן אותם בתו בריחה (escape): name
contains 'quinn\'s paper\\essay'
.
מה ברצונך לשלוח שאילתה? | דוגמה |
---|---|
קבצים בשם "hello" | name = 'hello' |
קבצים עם שם שמכיל את המילים "hello" ו'להתראות' | name contains 'hello' and name contains 'goodbye' |
קבצים שהשם שלהם לא מכיל את המילה "hello" | not name contains 'hello' |
קבצים שמכילים את הטקסט "important" באשפה | fullText contains 'important' and trashed = true |
קבצים שמכילים את המילה "hello" | fullText contains 'hello' |
קבצים שלא כוללים את המילה "hello" | not fullText contains 'hello' |
קבצים שמכילים את הביטוי המדויק "שלום עולם" | fullText contains '"hello world"' |
קבצים עם שאילתה שמכילה את "\" (לדוגמה, ' \authors') | fullText contains '\\authors' |
קבצים שהם תיקיות | mimeType = 'application/vnd.google-apps.folder' |
קבצים שאינם תיקיות | mimeType != 'application/vnd.google-apps.folder' |
קבצים שהשתנו אחרי תאריך מסוים (אזור הזמן שמוגדר כברירת מחדל הוא UTC) | modifiedTime > '2012-06-04T12:00:00' |
קובצי תמונה או וידאו שנערכו אחרי תאריך מסוים | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
קבצים שמסומנים בכוכב | starred = true |
קבצים בתוך אוסף (לדוגמה, מזהה התיקייה באוסף parents ) |
'1234567' in parents |
קבצים בתיקיית נתונים של אפליקציות באוסף | 'appDataFolder' in parents |
קבצים של המשתמש test@example.org הוא הבעלים | 'test@example.org' in owners |
קבצים של המשתמש test@example.org יש הרשאת כתיבה | 'test@example.org' in writers |
קבצים שעבורם חברים בקבוצה 'group@example.org' יש הרשאת כתיבה | 'group@example.org' in writers |
קבצים ששותפו עם המשתמש המורשה עם המילה 'hello' בשם | sharedWithMe and name contains 'hello' |
קבצים עם מאפיין קובץ מותאם אישית שגלויים לכל האפליקציות | properties has { key='mass' and value='1.3kg' } |
קבצים עם מאפיין קובץ מותאם אישית פרטי לאפליקציה ששלחה את הבקשה | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
קבצים שלא שותפו עם אף אחד או עם דומיינים (פרטיים בלבד, או שותפו עם קבוצות או משתמשים מסוימים) | visibility = 'limited' |
סינון תוצאות החיפוש באמצעות ספריית לקוח
דוגמת הקוד הבאה מראה איך להשתמש בספריית לקוח כדי לסנן את החיפוש
תוצאות לשמות קבצים ומזהים של קובצי JPEG. הדוגמה הזו משתמשת ברכיב mimeType
מונח של שאילתה כדי לצמצם את התוצאות לקבצים מסוג image/jpeg
. היא גם מגדירה
spaces
ל-drive
כדי לצמצם עוד יותר את החיפוש ל- Drive
רווח. כאשר nextPageToken
מחזירה null
,
אין יותר תוצאות.
Java
Python
Node.js
PHP
חיפוש קבצים עם מאפיין קובץ מותאם אישית
כדי לחפש קבצים עם מאפיין קובץ מותאם אישית, יש להשתמש באחת מהאפשרויות הבאות: properties
או
מונח שאילתת החיפוש appProperties
עם מפתח וערך. לדוגמה, כדי
לחפש מאפיין קובץ מותאם אישית שהוא פרטי לאפליקציה ששלחה את הבקשה
additionalID
עם ערך של 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
מידע נוסף זמין במאמר הוספת קובץ מותאם אישית נכסים דיגיטליים.
חיפוש קבצים עם תווית או ערך ספציפיים של שדה
כדי לחפש קבצים עם תוויות ספציפיות, צריך להשתמש במונח labels
של שאילתת החיפוש
עם מזהה תווית ספציפי. לדוגמה: 'labels/LABEL_ID' in
labels
. אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול את כל המופעים של הקובץ שבהם
הוחלה על כל התוויות.
כדי לחפש קבצים ללא מזהה תווית ספציפי: Not
'labels/LABEL_ID' in labels
.
אפשר גם לחפש קבצים לפי ערכים ספציפיים בשדות. לדוגמה, כדי
חיפוש קבצים עם ערך טקסט:
labels/LABEL_ID.text_field_id ='TEXT'
מידע נוסף זמין במאמר חיפוש קבצים עם תווית או שדה ספציפיים עם ערך מסוים.
חיפוש במאגר
חיפושים שמבצעים את החיפוש files.list
משתמשים באופרטור
corpora
מתוך user
כברירת מחדל. כדי לחפש
אוספים אחרים, כמו קבצים ששותפו עם domain
, מגדירים את corpora
הפרמטר.
ניתן לחפש מספר תאגידים בשאילתה אחת, אם כי התוצאות חלקיות
ניתן להחזיר אם הקורפורה המשולבת גדולה מדי. אם incompleteSearch
הוא
true
בגוף התשובה, אז כל המסמכים לא הוחזרו. אם
עליך לצמצם את השאילתה על ידי בחירת תאגיד אחר כמו
user
או drive
.
נושאים קשורים
- חיפוש של תיקיות אחסון שיתופי
- מונחים ואופרטורים של שאילתות חיפוש
- סוגי MIME נתמכים ב-Google Workspace וב-Google Drive
- תפקידים והרשאות
- חיפוש קבצים עם ערך ספציפי של תווית או שדה