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

‫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: מזהה כרטיס המוצר של האפליקציה הזו.

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