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

מדריך ההפניה הזה כולל מונחי שאילתה ואופרטורים שאפשר להשתמש בהם עם 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 אם אוסף ההורים מכיל את המזהה שצוין.
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 תוכלו למצוא תיאורים של סוגי הנתונים.

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

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