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

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

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

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

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

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

query_term operator values

כאשר:

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

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

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

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

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

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

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

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

מונח השאילתה אופרטורים תקינים שימוש
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 אם האוסף parents מכיל את המזהה שצוין. הבדיקה מתבצעת רק בתיקיות אב ישירות, ולא בתיקיות אב לא ישירות.
owners in משתמשים שהם הבעלים של הקובץ.
writers in משתמשים או קבוצות שיש להם הרשאה לשנות את הקובץ. למידע נוסף, עיינו במאמר permissions.
readers in משתמשים או קבוצות שיש להם הרשאה לקרוא את הקובץ. לפרטים נוספים, אפשר לעיין במאמר בנושא משאבים permissions.
sharedWithMe =, != קבצים שנמצאים באוסף 'קבצים ששותפו איתי' של המשתמש. כל המשתמשים בקובץ נמצאים ברשימת בקרת הגישה (ACL) של הקובץ. יכול להיות true או false.
createdTime <=,‏ <,‏ =,‏ !=,‏ >,‏ >= התאריך שבו הקובץ נוצר. צריך להשתמש בפורמט RFC 3339, אזור הזמן שמוגדר כברירת מחדל הוא UTC, למשל 2012-06-04T12:00:00-08:00. נתמך רק ב-Drive API v3.
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 there 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,‏ =,‏ != השם של האחסון השיתופי. צריך להקיף במירכאות בודדות ('). כדי להוסיף תו בריחה למירכאות בודדות בשאילתות, משתמשים ב-\', למשל 'Valentine\'s Day'. true
organizerCount <=,‏ <,‏ =,‏ !=,‏ >,‏ >= מספר המשתמשים והקבוצות שהם מנהלים של האחסון השיתופי. מקבל ערך מספרי. true
orgUnitId =, != מזהה היחידה הארגונית של האחסון השיתופי. מקבל ערך מחרוזת. true

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