במדריך הזה מוסבר איך Google Drive API תומך בכמה דרכים לחיפוש תיקיות משותפות.
כדי לחפש קבוצה ספציפית של תיקיות אחסון שיתופי, משתמשים בשדה q query
עם השיטה list במשאב drives כדי לסנן את תיקיות האחסון שיוחזרו על ידי שילוב של מונח חיפוש אחד או יותר.
מחרוזת שאילתה מכילה את שלושת החלקים הבאים:
query_term operator values
כאשר:
query_termהוא מונח השאילתה או השדה לחיפוש.
operatorמציין את התנאי למונח השאילתה.
valuesהם הערכים הספציפיים שרוצים להשתמש בהם כדי לסנן את תוצאות החיפוש.
לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כך שיוחזרו רק תיקיות אחסון שיתופי עם השם Google Drive API resources.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
כדי לראות את כל מונחי השאילתה של תיקיות באחסון השיתופי, אפשר לעיין במאמר מונחי שאילתה ספציפיים לתיקיות באחסון השיתופי.
כדי לראות את כל האופרטורים של השאילתות שאפשר להשתמש בהם כדי ליצור שאילתה, אפשר לעיין במאמר אופרטורים של שאילתות.
דוגמאות למחרוזות שאילתה
בטבלה הבאה מפורטות דוגמאות לכמה מחרוזות שאילתה בסיסיות לתיקיות משותפות. הקוד בפועל שונה בהתאם לספריית הלקוח שבה אתם משתמשים לחיפוש.
בנוסף, צריך להוסיף תווי בריחה (escape) לתווים מיוחדים בשמות הקבצים כדי לוודא שהשאילתה פועלת בצורה תקינה. לדוגמה, אם שם קובץ מכיל גם גרש (') וגם לוכסן הפוך ("\"), צריך להשתמש בלוכסן הפוך כדי לבטל את המשמעות שלהם: name
contains 'quinn\'s paper\\essay'.
| מה לשאול | דוגמה | הגדרה useDomainAdminAccess |
|---|---|---|
אופרטור להתאמת מחרוזות (contains) |
||
| תיקיות אחסון שיתופי שהמילה 'סודי' מופיעה בשם שלהן, מתוך כל תיקיות האחסון השיתופי שהמשתמש חבר בהן | name contains 'confidential' |
false |
אופרטורים של שוויון ואי-שוויון (=, !=) |
||
| תיקיות אחסון שיתופי שמוצגות בתצוגת ברירת המחדל | hidden = false |
false |
| תיקיות אחסון שיתופי שמוסתרות מהתצוגה שמוגדרת כברירת מחדל | hidden = true |
false |
| תיקיות אחסון שיתופי ללא מארגן שהוקצה | organizerCount = 0 |
true |
| תיקיות באחסון השיתופי שיש בהן חבר אחד בלבד | memberCount = 1 |
true |
| תיקיות אחסון שיתופי ששייכות למזהה היחידה הארגונית | orgUnitId = 'C03az79cb' |
true |
| תיקיות אחסון שיתופי שלא מכילות את מזהה היחידה הארגונית | orgUnitId != 'C03az79cb' |
true |
| תיקיות באחסון שיתופי שהשמות שלהן לא תואמים לשם ספציפי | name != 'Archived Projects' |
true |
אופרטורים להשוואה (>, >=, <, <=) |
||
| תיקיות באחסון שיתופי שנוצרו אחרי 1 ביוני 2017 | createdTime > '2017-06-01T12:00:00' |
true |
| אחסון שיתופי שנוצר לפני 1 בינואר 2023 | createdTime < '2023-01-01T00:00:00' |
true |
| תיקיות אחסון שיתופי עם יותר מחבר אחד | memberCount > 1 |
true |
| אחסונים שיתופיים עם פחות מ-5 חברים | memberCount < 5 |
true |
| תיקיות אחסון שיתופי עם 3 מארגנים או פחות | organizerCount <= 3 |
true |
אופרטורים לוגיים (and, or, not) |
||
| תיקיות אחסון שיתופי עם המילה 'סודי' בכותרת ו-20 חברים או יותר | name contains 'confidential' and memberCount >= 20 |
true |
| תיקיות באחסון השיתופי שהמילה 'סודי' מופיעה בשם שלהן, מתוך כל התיקיות באחסון השיתופי של הארגון | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| תיקיות אחסון שיתופי שהשמות שלהן מכילים את המילה Project או את המילה Archive | name contains 'Project' or name contains 'Archive' |
true |
| תיקיות אחסון שיתופי שהשם שלהן לא מכיל את המילה 'טיוטה' | not name contains 'Draft' |
true |
| תיקיות אחסון שיתופי שלא שייכות ליחידה ארגונית יעד ונוצרו אחרי תאריך מסוים | orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' |
true |
חיפוש כמה מונחים באמצעות סוגריים
אפשר להשתמש בסוגריים כדי לקבץ כמה מונחי שאילתה יחד. לדוגמה, כדי לחפש תיקיות של אחסון שיתופי שנוצרו אחרי תאריך מסוים, ושכוללות יותר מחמישה מארגנים או יותר מ-20 חברים, משתמשים בשאילתה הבאה:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)
החיפוש הזה יחזיר את כל תיקיות האחסון השיתופי שנוצרו אחרי 1 בינואר 2019, ושמוגדרים בהן יותר מחמישה בעלי הרשאת ניהול או יותר מ-20 חברים.
ממשק Drive API מעריך את האופרטורים and ו-or משמאל לימין, ולכן אותה שאילתה ללא סוגריים תחזיר:
- רק אחסון שיתופי עם יותר מחמישה מארגנים שנוצר אחרי 1 בינואר 2019.
- כל תיקיות האחסון השיתופי עם יותר מ-20 חברים, גם אלה שנוצרו לפני 1 בינואר 2019.