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

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

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

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

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

הצגת פרטים על משתמש

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

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

בדוגמת הקוד הבאה מוסבר איך לספק כמה ערכים של fields כפרמטר של שאילתה בבקשה. התגובה מחזירה את ערכי השדות של הבקשה.

בקשה

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"
  }
}

התשובה כוללת את הערכים הבאים:

  • DISPLAY_NAME: שם המשתמש בטקסט פשוט.
  • PHOTO_LINK: כתובת ה-URL של תמונת הפרופיל של המשתמש.
  • PERMISSION_ID: המזהה של המשתמש במשאבי Permission.
  • EMAIL_ADDRESS: כתובת האימייל של המשתמש

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

אפליקציות של 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"
  ]
}

התשובה כוללת את הערכים הבאים:

  • ID: מזהה האפליקציה.
  • PRODUCT_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 עם מזהה האפליקציה.

בדוגמת הקוד הבאה מוסבר איך לספק את appId כפרמטר של שאילתה בבקשה. התגובה מחזירה את ערכי השדות של הבקשה.

בקשה

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"
}

התשובה כוללת את הערכים הבאים:

  • ID: מזהה האפליקציה.
  • PRODUCT_ID: מזהה כרטיס המוצר של האפליקציה הזו.

הנה כמה שלבים אפשריים שאפשר לנסות: