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

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

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

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

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

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

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

בשיטה get(), הפרמטר fields נדרש כדי לרשום את השדות שיוחזר בתשובה. אם משמיטים את הפרמטר, השיטה מחזירה שגיאה. במאמר החזרת שדות ספציפיים מוסבר איך מחזירים את השדות הספציפיים שדרושים לכם.

הצג דוגמה

בקטע הקוד הבא מוצג איך לספק כמה ערכים של 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, משתמשים ב-method‏ list() בלי פרמטרים.

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

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