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