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

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

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

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

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

אחזור מידע על משתמש

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

הצג דוגמה

דוגמת הקוד הבאה מראה איך לציין כמה 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 או תוסף שמשמש לחתימה על מסמכים. למידע נוסף, קראו את המאמר שימוש באפליקציות של Google Drive.

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

הצג דוגמה

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

שליחת בקשה

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

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