פרטי משתמש החזרה

‫Google Drive מספק שתי אפשרויות לאיסוף מידע על משתמשי Drive:

• באמצעות מקור המידע about, אפשר לאחזר מידע על המשתמש, על הגדרות Drive שלו ועל היכולות של המערכת שלו.

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

במדריך הזה מוסבר איך אפשר לאחזר פרטי משתמש ב-Drive.

איך מקבלים פרטים על משתמש

כדי להחזיר מידע על משתמש ב-Drive כמופע של about, משתמשים בשיטה get. הערכים שמוחזרים נמדדים בבייטים.

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

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

הצגת אפליקציות למשתמש

אפליקציות ל-Google Drive מופיעות ב-Google Workspace Marketplace ומשמשות כדי להפוך את השימוש ב-Drive לנוח יותר, כמו אפליקציית Google Docs או תוסף שמשמש ב-Docs לחתימה על מסמכים. מידע נוסף זמין במאמר שימוש באפליקציות של Google Drive.

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

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

GET https://www.googleapis.com/drive/v3/apps

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

רשימת אפליקציות של משתמשים עם פרמטרים של שאילתה

כדי למצוא אפליקציה ספציפית, משתמשים בפרמטר שאילתה אופציונלי אחד או יותר:

• ‫appFilterExtensions: סינון תוצאות החיפוש באמצעות רשימה של סיומות קבצים שמופרדות באמצעות פסיק. התשובה כוללת אפליקציות שנמצאות בהיקף השאילתה של האפליקציה ויכולות לפתוח את סיומות הקבצים שמופיעות ברשימה. אם מספקים גם את appFilterMimeTypes, מוחזר איחוד של שתי רשימות האפליקציות שמתקבלות. דוגמאות לתוספים: docx ל-Microsoft Word ו-pptx ל-Microsoft PowerPoint. דוגמאות נוספות לסיומות של קבצים זמינות במאמר ייצוא סוגי MIME של מסמכים ב-Google Workspace.

  בדוגמת הקוד הבאה מוצג איך מספקים כמה סיומות קבצים כפרמטר שאילתה: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

• ‫appFilterMimeTypes: סינון תוצאות החיפוש באמצעות רשימה מופרדת בפסיקים של סוגי MIME. התשובה כוללת אפליקציות בתחום השאילתה של האפליקציה שיכולות לפתוח את סוגי ה-MIME שמופיעים ברשימה. אם מספקים גם את appFilterExtensions, מוחזר איחוד של שתי רשימות האפליקציות שמתקבלות. דוגמאות לסוגי MIME כוללות application/vnd.google-apps.form ל-Google Forms ו-application/vnd.google-apps.site ל-Google Sites. דוגמאות נוספות לסוגי MIME מופיעות במאמר סוגי MIME שנתמכים ב-Google Workspace וב-Google Drive.

  בדוגמת הקוד הבאה אפשר לראות איך מספקים כמה סוגי MIME כפרמטר של שאילתה: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

• ‫languageCode: סינון תוצאות החיפוש באמצעות קוד שפה או קוד אזור, כפי שמוגדר ב-BCP 47, עם כמה הרחבות מפורמט LDML של Unicode. דוגמאות לקודי שפה: ‫en-us לאנגלית (ארצות הברית) ו-fr-ca לצרפתית (קנדה).

  בדוגמת הקוד הבאה אפשר לראות איך מספקים כמה קודי שפה כפרמטר שאילתה: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

אחזור אפליקציה של משתמש לפי מזהה

כדי להוריד את פרטי האפליקציה המפורטים כמופע של apps, משתמשים בשיטה get עם מזהה האפליקציה.

GET https://www.googleapis.com/drive/v3/apps/APP_ID

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

נושאים קשורים

הנה כמה פעולות שאפשר לנסות:

• במאמר יצירה וניהול של קבצים מוסבר איך ליצור קובץ ב-Drive.

• כדי להעלות נתוני קבצים כשיוצרים או מעדכנים קובץ, אפשר לעיין במאמר בנושא העלאת נתוני קבצים.

• כדי להוריד ולייצא קבצים, ראו הורדה וייצוא של קבצים.