כדי לחפש קבוצה ספציפית של תיקיות אחסון שיתופי, משתמשים בשדה 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.