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

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

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

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

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

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

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

חובה להגדיר את fields פרמטר המערכת בשיטה get כדי לציין את השדות שיוחזרו בתגובה. ברוב ה-methods של 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: מזהה כרטיס המוצר של האפליקציה הזו.

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