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