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

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

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