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

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

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

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

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

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

query_term operator values

כאשר:

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

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

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

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

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

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

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

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

מונח השאילתה אופרטורים חוקיים Usage
name contains,‏ =,‏ != שם הקובץ. מוקף במירכאות יחידות ('). תו בריחה של מירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'.
fullText contains האם המאפיינים name, description, indexableText או הטקסט בתוכן או במטא-נתונים של הקובץ תואמים. מוקף במירכאות יחידות ('). תו בריחה של מירכאות בודדות בשאילתות באמצעות \', כמו 'Valentine\'s Day'.
mimeType contains,‏ =,‏ != סוג ה-MIME של הקובץ. מוקף במירכאות יחידות ('). תו בריחה של מירכאות בודדות בשאילתות באמצעות \', כמו '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 שם עולם', השאילתה fullText contains '"Hello there"' תחזיר תוצאה, אבל השאילתה fullText contains '"Hello world"' לא תחזיר אותה. בנוסף, מכיוון שהחיפוש הוא אלפאנומרי, אם הטקסט המלא של מסמך מכיל את המחרוזת 'Hello_world', השאילתה fullText contains '"Hello world"' מחזירה תוצאה.

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

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

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

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

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

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