פרטי משתמש החזרה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
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: מזהה כרטיס המוצר של האפליקציה הזו.
הנה כמה פעולות שאפשר לנסות:
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-09-01 (שעון UTC).
[null,null,["עדכון אחרון: 2025-09-01 (שעון UTC)."],[],[],null,["Google Drive provides two options to gather information about\nDrive users:\n\n- Using the [`about`](/workspace/drive/api/reference/rest/v3/about) resource, you can retrieve\n information about the user, the user's Drive settings, and\n their system capabilities.\n\n- Using the [`apps`](/workspace/drive/api/reference/rest/v3/apps) resource, you can retrieve a\n list of the user's installed apps, with information about each app's\n supported MIME types, file extensions, and other details.\n\nThis guide explains how you can retrieve user info in Drive.\n\nGet details about a user\n\nTo return information on a Drive user as an instance of\n[`about`](/workspace/drive/api/reference/rest/v3/about), use the\n[`get`](/workspace/drive/api/reference/rest/v3/about/get) method. The returned values are measured\nin bytes.\n\nYou *must* set the `fields` [system\nparameter](https://cloud.google.com/apis/docs/system-parameters#definitions) on\nthe `get` method to specify the fields to return in the response. In most\nDrive methods this action is only required to return non-default\nfields but it's mandatory for the `about` resource. If you omit the parameter,\nthe method returns an error. For more information, see [Return specific fields](/workspace/drive/api/guides/fields-parameter).\n| **Note:** If you're using the previous Drive API v2 version, setting the `fields` parameter in the `get` method isn't required. Learn how to [migrate to\nDrive API v3](/workspace/drive/api/guides/migrate-to-v3). \nThe following code sample shows how to provide multiple `fields` as a query parameter in the request. The response returns the field values for the request.\n\n**Request** \n\n```text\nGET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#about\",\n \"user\": {\n \"kind": \"drive#user\",\n \"displayName\": \"DISPLAY_NAME\",\n \"photoLink\": \"PHOTO_LINK\";,\n \"me\": true,\n \"permissionId\": \"PERMISSION_ID\",\n \"emailAddress\": \"EMAIL_ADDRESS\"\n },\n \"storageQuota\": {\n \"usage\": \"10845031958\",\n \"usageInDrive\": \"2222008387\",\n \"usageInDriveTrash\": \"91566\"\n }\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eDISPLAY_NAME\u003c/var\u003e: the user's name in plain text.\n- \u003cvar translate=\"no\"\u003ePHOTO_LINK\u003c/var\u003e: the URL of the user's profile photo.\n- \u003cvar translate=\"no\"\u003ePERMISSION_ID\u003c/var\u003e: the user's ID within the `Permission` resources.\n- \u003cvar translate=\"no\"\u003eEMAIL_ADDRESS\u003c/var\u003e: the user's email address\n\nList user apps\n\nGoogle Drive apps are listed in the\n[Google Workspace Marketplace](https://workspace.google.com/marketplace) and\nare used to make Drive more convenient such as the Google Docs\napp or an add-on used within Docs to\nsign documents. For more information, see [Use Google Drive\napps](https://support.google.com/drive/answer/2500820).\n\nTo return a list of all the user's installed apps as an instance of [`apps`](/workspace/drive/api/reference/rest/v3/apps), use the [`list`](/workspace/drive/api/reference/rest/v3/apps/list) method\nwithout any parameters.\n\nIf you want to specify the fields to return in the response, you can set the\n`fields` [system\nparameter](https://cloud.google.com/apis/docs/system-parameters#definitions). If\nyou don't specify the `fields` parameter, the server returns a default set of\nfields. For more information, see [Return specific fields](/workspace/drive/api/guides/fields-parameter).\n| **Note:** If you're using the previous Drive API v2 version, the response body also includes the `etag` field. Learn how to [migrate to\nDrive API v3](/workspace/drive/api/guides/migrate-to-v3). \nThe following code sample shows how to return a list of all the user's installed apps in the request. The response returns the field values for the request.\n\n**Request** \n\n```text\nGET https://www.googleapis.com/drive/v3/apps\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#appList\",\n \"selfLink\": \"https://www.googleapis.com/drive/v3/apps\",\n \"items\": [\n {\n \"kind\": \"drive#app\",\n \"id\": \"ID\",\n \"name\": \"Google Sheets\",\n \"supportsCreate\": true,\n \"supportsImport\": true,\n \"supportsMultiOpen\": false,\n \"supportsOfflineCreate\": true,\n \"productUrl\": \"https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap\",\n \"productId\": \"PRODUCT_ID\"\n }\n ],\n \"defaultAppIds\": [\n \"ID\"\n ]\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eID\u003c/var\u003e: the app ID.\n- \u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e: the product listing ID for this app.\n\nList user apps with query parameters\n\nTo find a specific app, use one or more of the optional query parameters:\n\n- `appFilterExtensions`: Filter the search results using a comma-separated\n list of file extensions. Apps within the app query scope that can open the\n listed file extensions are included in the response. If `appFilterMimeTypes`\n are also provided, a union of the two resulting app lists is returned.\n Examples of extensions include `docx` for Microsoft Word and `pptx` for\n Microsoft PowerPoint. For more examples of file extensions, see [Export MIME\n types for Google Workspace documents](/workspace/drive/api/guides/ref-export-formats).\n\n The following code sample shows how to provide multiple file extensions as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx`.\n- `appFilterMimeTypes`: Filter the search results using a comma-separated list\n of MIME types. Apps within the app query scope that can open the listed MIME\n types are included in the response. If `appFilterExtensions` are also\n provided, a union of the two resulting app lists is returned. Examples of\n MIME types include `application/vnd.google-apps.form` for Google Forms and\n `application/vnd.google-apps.site` for Google Sites. For more examples of\n MIME types, see [Google Workspace and Google Drive supported MIME\n types](/workspace/drive/api/guides/mime-types).\n\n The following code sample shows how to provide multiple MIME types as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site`.\n- `languageCode`: Filter the search results using a language or locale code,\n as defined by BCP 47, with some extensions from [Unicode's LDML\n format](https://www.unicode.org/reports/tr35/). Examples of language codes\n include `en-us` for English (United States) and `fr-ca` for French (Canada).\n\n The following code sample shows how to provide multiple language codes as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca`.\n\nGet user app by ID\n\nTo download the detailed app info as an instance of\n[`apps`](/workspace/drive/api/reference/rest/v3/apps), use the [`get`](/workspace/drive/api/reference/rest/v3/apps/get)\nmethod with the app ID. \nThe following code sample shows how to provide an `appId` as a query parameter in the request. The response returns the field values for the request.\n\n**Request** \n\n```scdoc\nGET https://www.googleapis.com/drive/v3/apps/APP_ID\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#app\",\n \"id\": \"ID\",\n \"name\": \"Google Sheets\",\n \"supportsCreate\": true,\n \"supportsImport\": true,\n \"supportsMultiOpen\": false,\n \"supportsOfflineCreate\": true,\n \"productUrl": \"https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap\",\n \"productId\": \"PRODUCT_ID\"\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eID\u003c/var\u003e: the app ID.\n- \u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e: the product listing ID for this app.\n\nRelated topics\n\nHere are a few next steps you might try:\n\n- To create a file in Drive, see [Create and manage files](/workspace/drive/api/guides/create-file).\n\n- To upload file data when you create or update a file, see [Upload file\n data](/workspace/drive/api/guides/manage-uploads).\n\n- To download and export files, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads)."]]
