כדי לחפש קבוצה ספציפית של תיקיות אחסון שיתופי, משתמשים בשדה 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 חברים.
ממשק ה-API של Drive מעריך את האופרטורים and ו-or משמאל לימין, כך שאותו חיפוש ללא סוגריים יחזיר את התוצאה הבאה:
- רק אחסונים משותפים עם יותר מחמישה מארגנים שנוצרו אחרי 1 בינואר 2019.
- כל תיקיות האחסון השיתופי שיש בהן יותר מ-20 חברים, גם כאלה שנוצרו לפני 1 בינואר 2019.