כדי לחפש קבוצה ספציפית של תיקיות אחסון שיתופי, משתמשים בשדה q של מחרוזת השאילתה עם drives.list כדי לסנן את התיקיות שיוצגו על ידי שילוב של מונח חיפוש אחד או יותר.
מחרוזת שאילתה מכילה את שלושת החלקים הבאים:
query_term operator values
כאשר:
query_termהוא מונח השאילתה או השדה לחיפוש.operatorמציין את התנאי של מונח השאילתה.valuesהם הערכים הספציפיים שבהם רוצים להשתמש כדי לסנן את תוצאות החיפוש.
במאמר מונחים ואופרטורים של שאילתות חיפוש תוכלו למצוא מידע על המונחים והאופרטורים של השאילתות שאפשר להשתמש בהם כדי לסנן תיקיות אחסון שיתופי.
לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כך שיחזיר רק תיקיות אחסון שיתופיות בשם 'משאבי Google Drive API'.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
דוגמאות למחרוזות שאילתה
בטבלה הבאה מפורטות דוגמאות למחרוזות שאילתה בסיסיות לכונני אחסון משותפים. הקוד בפועל משתנה בהתאם לספריית הלקוח שבה משתמשים לחיפוש.
צריך גם להשתמש בתווי בריחה (escape) בתווים המיוחדים בשמות הקבצים כדי לוודא שהשאילתה פועלת כמו שצריך. לדוגמה, אם שם קובץ מכיל גם גרש (') וגם תו לוכסן הפוך ("\"), צריך להשתמש בקו נטוי הפוך כדי לסמן אותם בתו בריחה (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 |
שליחת שאילתות על כמה מונחים בסוגריים
אפשר להשתמש בסוגריים כדי לקבץ יחד כמה מונחי שאילתה. לדוגמה, כדי לחפש תיקיות אחסון שיתופי שנוצרו אחרי תאריך מסוים ושיש להן יותר מ-5 מארגנים או יותר מ-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.