חיפוש תיקיות אחסון שיתופי

כדי לחפש קבוצה ספציפית של תיקיות אחסון שיתופי, משתמשים בשדה q של מחרוזת השאילתה עם drives.list כדי לסנן את תיקיות האחסון שיוחזרו על ידי שילוב של מונח חיפוש אחד או יותר.

מחרוזת שאילתה כוללת את שלושת החלקים הבאים:

query_term operator values

כאשר:

  • ‫query_term הוא מונח השאילתה או השדה לחיפוש.

  • ‫operator מציין את התנאי למונח השאילתה.

  • ‫values הם הערכים הספציפיים שרוצים להשתמש בהם כדי לסנן את תוצאות החיפוש.

כדי לראות את המונחים והאופרטורים של שאילתות שאפשר להשתמש בהם לסינון תיקיות משותפות, אפשר לעיין במאמר מונחים ואופרטורים של שאילתות חיפוש.

לדוגמה, מחרוזת השאילתה הבאה מסננת את החיפוש כך שיוחזרו רק תיקיות אחסון שיתופי עם השם Google Drive API resources.

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.