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