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

במדריך הזה מפורטים מונחים ואופרטורים של שאילתות שאפשר להשתמש בהם עם 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

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