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

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

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

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

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

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

query_term operator values

כאשר:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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