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