‫Drive – רשימת משימות

המשימה Drive - List מאפשרת לחפש ולאחזר קבצים ותיקיות שמאוחסנים בחשבון Google Drive.

‫Google Drive הוא שירות לאחסון קבצים בענן, שמספק לכם נפח אחסון אישי שבו אתם יכולים לאחסן תיקיות וקבצים משותפים ולגשת אליהם בענן.

לפני שמתחילים

לפני שמגדירים את המשימה Drive - List, צריך לוודא שמבצעים את המשימות הבאות בפרויקט בענן של Google.

  1. מפעילים את Google Drive API‏ (drive.googleapis.com).

    מפעילים את Google Drive API

  2. יוצרים פרופיל אימות. Application Integration משתמש בפרופיל אימות כדי להתחבר לנקודת קצה של אימות למשימה Drive - List.

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

הגדרת המשימה Drive - List

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    מעבר אל Application Integration

  2. בתפריט הניווט, לוחצים על Integrations (שילובים).

    מוצג הדף Integrations (שילובים) עם רשימה של כל השילובים שזמינים בפרויקט בענן של Google.

  3. בוחרים שילוב קיים או לוחצים על יצירת שילוב כדי ליצור שילוב חדש.

    אם יוצרים שילוב חדש:

    1. מזינים שם ותיאור בחלונית יצירת שילוב.
    2. בוחרים אזור לשילוב.
    3. בוחרים חשבון שירות לאינטגרציה. אפשר לשנות או לעדכן את פרטי חשבון השירות של שילוב בכל שלב מחלונית סיכום השילוב בסרגל הכלים של השילוב.
    4. לוחצים על יצירה. השילוב החדש שנוצר ייפתח בכלי השילובים.

  4. בסרגל הניווט של כלי העריכה של השילוב, לוחצים על משימות כדי לראות את רשימת המשימות והמחברים הזמינים.
  5. לוחצים על הרכיב Drive - List וגוררים אותו למיקום הרצוי בכלי לעריכת שילובים.
  6. לוחצים על הרכיב Drive - List (רשימה ב-Drive) בכלי העיצוב כדי להציג את חלונית ההגדרות של המשימה Drive - List.
  7. עוברים אל אימות ובוחרים פרופיל אימות קיים שרוצים להשתמש בו.

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

  8. עוברים אל Task Input ומגדירים את שדות הקלט הרצויים באמצעות הטבלה הבאה של Task input parameters.

    השינויים בשדות הקלט נשמרים אוטומטית.

פרמטרים של קלט למשימה

בטבלה הבאה מפורטים פרמטרי הקלט של המשימה Drive - List:

מאפיין (property) סוג נתונים תיאור
Corpora String פרמטר אופציונלי לחיפוש קבצים במקורות מידע.
DriveId String המזהה של האחסון השיתופי שלכם ב-Google.
IncludeItemsFromAllDrives בוליאני אם רוצים לכלול בתוצאות החיפוש גם פריטים מהאחסון האישי וגם פריטים מהאחסון השיתופי, צריך להגדיר את הערך כ-true.

ערך ברירת המחדל: false.
IncludeLabels String רשימה מופרדת בפסיקים של מזהי תוויות שנכללת בחלק labelInfo של התשובה. מידע נוסף על מזהי תוויות זמין במאמר סקירה כללית על תוויות.
IncludePermissionsForView String מציינים את published. מידע נוסף זמין במאמר בנושא שיתוף קבצים, תיקיות ותיקיות אחסון שיתופי.
OrderBy String הסדר שבו הקבצים ממוינים. כברירת מחדל, כל מפתח ממוין בסדר עולה. מידע נוסף זמין במאמר בנושא השיטה files.list.

אלו הם הערכים התקינים:

  • createdTime
  • folder
  • modifiedByMeTime
  • modifiedTime
  • name
  • name_natural
  • quotaBytesUsed
  • recency
  • sharedWithMeTime
  • starred
  • viewedByMeTime
PageSize מספר שלם המספר המקסימלי של קבצים שיוחזרו בכל דף.

הערכים הקבילים הם 1 עד 1000.

ערך ברירת המחדל: 100.
PageToken String הטוקן להמשך של משימת Drive - List קודמת. מגדירים את הערך הזה לערך של nextPageToken מהתגובה הקודמת.
Q String שאילתה לסינון התוצאות של הקובץ. מידע נוסף זמין במאמר בנושא חיפוש קבצים.
Spaces String רשימה מופרדת בפסיקים של מרחבים לחיפוש בתוך מאגרי המידע.

הערכים הקבילים הם drive ו-appDataFolder.

SupportsAllDrives בוליאני אם האפליקציה ששולחת את הבקשה תומכת גם בתיקיית 'האחסון שלי' וגם בתיקיות אחסון שיתופי, צריך להגדיר את הערך true.

ערך ברירת המחדל: false.

פלט המשימה

המשימה Drive - List מחזירה את פלט התגובה שמכיל את רשימת הקבצים. דוגמה לפלט:

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

אסטרטגיה לטיפול בשגיאות

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

מכסות ומגבלות

מידע על מכסות ומגבלות זמין במאמר מכסות ומגבלות.

המאמרים הבאים