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