מונחים ואופרטורים של שאילתות חיפוש

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

לדוגמאות לחיפוש קבצים, ראו חיפוש קבצים ותיקיות.

דוגמאות לחיפושים של תיקיות אחסון שיתופי זמינות במאמר חיפוש תיקיות אחסון שיתופי.

התחביר של מחרוזות השאילתה

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

query_term operator values

כאשר:

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

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

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

אופרטורים של שאילתות

בטבלה הבאה מפורטים האופרטורים החוקיים של השאילתות:

מפעיל שימוש
contains התוכן של מחרוזת אחת מופיע במחרוזת השנייה.
= התוכן של מחרוזת או ערך בוליאני שווה לזה.
!= התוכן של מחרוזת או ערך בוליאני לא שווה לזה.
< הערך קטן מערך אחר.
<= ערך מסוים קטן מהערך אחר או שווה לו.
> הערך גדול יותר מהערך אחר.
>= ערך גדול יותר מערך אחר או שווה לו.
in רכיב כלול בתוך אוסף.
and מוחזרים פריטים שתואמים לשתי השאילתות.
or החזרת פריטים שתואמים לאחת מהשאילתות.
not מוחק שאילתת חיפוש.
has אוסף מכיל רכיב שתואם לפרמטרים.

מונחי שאילתה ספציפיים לקובץ

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

מונח השאילתה אופרטורים חוקיים שימוש
name contains, = != שם הקובץ. מוקף במירכאות יחידות ('). תו בריחה (escape) למירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'.
fullText contains האם המאפיינים name, description, indexableText או הטקסט בתוכן או במטא-נתונים של הקובץ תואמים. מוקף במירכאות יחידות ('). תו בריחה (escape) למירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'.
mimeType contains, = != סוג ה-MIME של הקובץ. מוקף במירכאות יחידות ('). תו בריחה (escape) למירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'. מידע נוסף על סוגי MIME זמין במאמר סוגי MIME נתמכים ב-Google Workspace וב-Google Drive.
modifiedTime <=, <, =, !=, >, >= תאריך השינוי האחרון של הקובץ. פורמט RFC 3339. אזור הזמן שמוגדר כברירת מחדל הוא UTC, לדוגמה 2012-06-04T12:00:00-08:00. לא ניתן להשוות בין שדות מסוג date, אלא רק לתאריכים קבועים.
viewedByMeTime <=, <, =, !=, >, >= התאריך שבו המשתמש צפה לאחרונה בקובץ. פורמט RFC 3339. אזור הזמן שמוגדר כברירת מחדל הוא UTC, לדוגמה 2012-06-04T12:00:00-08:00. לא ניתן להשוות בין שדות מסוג date, אלא רק לתאריכים קבועים.
trashed =, != אם הקובץ נמצא באשפה או לא. הוא יכול להיות true או false.
starred =, != האם הקובץ מסומן בכוכב או לא. הוא יכול להיות true או false.
parents in האם אוסף ההורים מכיל את המזהה שצוין.
owners in משתמשים שהם הבעלים של הקובץ.
writers in משתמשים או קבוצות שיש להם הרשאה לבצע שינויים בקובץ. אפשר לעיין בחומר העזר בנושא משאבים ב-permissions.
readers in משתמשים או קבוצות שיש להם הרשאה לקרוא את הקובץ. אפשר לעיין בחומר העזר בנושא משאבים ב-permissions.
sharedWithMe =, != קבצים שנמצאים בתיקיית 'קבצים ששותפו איתי' של המשתמש האוסף 'אוסף'. כל המשתמשים בקובץ נמצאים ברשימה של בקרת גישה (ACL) של הקובץ. הוא יכול להיות true או false.
createdTime <=, <, =, !=, >, >= התאריך שבו נוצר האחסון השיתופי. צריך להשתמש בפורמט RFC 3339. אזור הזמן שמוגדר כברירת מחדל הוא UTC, לדוגמה 2012-06-04T12:00:00-08:00.
properties has מאפייני קובץ ציבוריים בהתאמה אישית.
appProperties has מאפייני קובץ פרטי בהתאמה אישית.
visibility =, != רמת החשיפה של הקובץ. הערכים החוקיים הם anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink ו-limited. מוקף במירכאות יחידות (').
shortcutDetails.targetId =, != המזהה של הפריט שקיצור הדרך מפנה אליו.

הדוגמה הבאה מציגה שילובים של אופרטורים ומונחי שאילתה:

  • האופרטור contains מבצע התאמת קידומת רק עבור מונח name. לדוגמה, נניח שיש לכם שם מתוך HelloWorld. השאילתה של name contains 'Hello' מחזירה אבל שאילתה של name contains 'World' לא תניב תוצאות.

  • האופרטור contains מבצע התאמות רק עבור אסימונים שלמים של מחרוזת את המונח fullText. לדוגמה, אם הטקסט המלא של מסמך כולל המחרוזת "HelloWorld", רק השאילתה fullText contains 'HelloWorld' מחזירה תוצאה.

  • האופרטור contains מתאים לביטוי אלפאנומרי מדויק, אם הוא מוקף במירכאות כפולות. לדוגמה, אם fullText של מסמך מכיל את המחרוזת "Hello Hello World", השאילתה fullText contains '"Hello there"' מחזירה תוצאה, אבל השאילתה fullText contains '"Hello world"' לא. בנוסף, מכיוון שהחיפוש הוא אלפאנומרי, אם טקסט של מסמך מכיל את המחרוזת "Hello_world", ולאחר מכן את השאילתה הפונקציה fullText contains '"Hello world"' מחזירה תוצאה.

  • המונחים owners, writers ו-readers משתקפים באופן עקיף permissions ומעיינים role בהרשאה. רשימה מלאה של הרשאות התפקידים זמינה במאמר תפקידים והרשאות.

לדוגמאות נוספות של חיפושים במחרוזות שאילתה, ראו מחרוזת של שאילתת קובץ דוגמאות.

מונחי שאילתה ספציפיים לאחסון שיתופי

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

מונח השאילתה אופרטורים חוקיים שימוש הגדרה useDomainAdminAccess
createdTime <=, <, =, !=, >, >= התאריך שבו נוצר האחסון השיתופי. פורמט RFC 3339. אזור הזמן שמוגדר כברירת מחדל הוא UTC, לדוגמה 2012-06-04T12:00:00-08:00. true
hidden =, != מציינת אם האחסון השיתופי מוסתר. הוא יכול להיות true או false. false
memberCount <=, <, =, !=, >, >= מספר המשתמשים והקבוצות שחברים באחסון השיתופי. הפונקציה מקבלת ערך מספרי. true
name contains, = != השם של האחסון השיתופי. מוקף במירכאות יחידות ('). תו בריחה (escape) למירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= מספר המשתמשים והקבוצות שהם מארגנים של האחסון השיתופי. הפונקציה מקבלת ערך מספרי. true
orgUnitId =, != מזהה היחידה הארגונית של האחסון השיתופי. הפונקציה מקבלת ערך של מחרוזת. true

לדוגמאות נוספות של חיפושים במחרוזות שאילתה, ראו מחרוזת שאילתה באחסון השיתופי דוגמאות.