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

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

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

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

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

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

query_term operator values

כאשר:

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

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

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

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

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

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

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

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

מונח שאילתה אופרטורים תקינים שימוש
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 there world', השאילתה fullText contains '"Hello there"' תחזיר תוצאה, אבל השאילתה fullText contains '"Hello world"' לא תחזיר תוצאה.

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

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

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

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

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

מונח שאילתה אופרטורים תקינים שימוש הגדרה 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

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