اطلاعات کاربر را برگردانید، اطلاعات کاربر را برگردانید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Google Drive دو گزینه برای جمع آوری اطلاعات در مورد کاربران Drive ارائه می دهد:
با استفاده از منبع about ، می توانید اطلاعات مربوط به کاربر، تنظیمات Drive کاربر و قابلیت های سیستم آنها را بازیابی کنید.
با استفاده از منبع apps ، می‌توانید فهرستی از برنامه‌های نصب‌شده کاربر را با اطلاعاتی درباره انواع MIME، پسوند فایل و سایر جزئیات هر برنامه بازیابی کنید.
این راهنما توضیح می دهد که چگونه می توانید اطلاعات کاربر را در Drive بازیابی کنید.
دریافت جزئیات در مورد یک کاربر
برای برگرداندن اطلاعات یک کاربر Drive به عنوان نمونه ای از about ، از روش get استفاده کنید. مقادیر برگشتی بر حسب بایت اندازه گیری می شوند.
بایدپارامتر سیستمfields را روی متد get تنظیم کنید تا فیلدهایی را که باید در پاسخ بازگردانده شوند مشخص کنید. در اکثر روش‌های Drive، این عمل فقط برای برگرداندن فیلدهای غیر پیش‌فرض مورد نیاز است، اما برای منبع about اجباری است. اگر پارامتر را حذف کنید، متد یک خطا برمی گرداند. برای اطلاعات بیشتر، به قسمت‌های خاص بازگشت مراجعه کنید.
نمونه کد زیر نحوه ارائه چندین fields به عنوان پارامتر پرس و جو در درخواست را نشان می دهد. پاسخ مقادیر فیلد درخواست را برمی گرداند.
درخواست کنید
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
برنامه‌های Google Drive در Google Workspace Marketplace فهرست شده‌اند و برای راحت‌تر کردن Drive استفاده می‌شوند، مانند برنامه Google Docs یا افزونه‌ای که در Docs برای امضای اسناد استفاده می‌شود. برای اطلاعات بیشتر، به استفاده از برنامه‌های Google Drive مراجعه کنید.
برای برگرداندن فهرستی از همه برنامه‌های نصب‌شده کاربر به‌عنوان نمونه‌ای از apps ، از روش list بدون هیچ پارامتری استفاده کنید.
اگر می‌خواهید فیلدهایی را برای بازگشت در پاسخ مشخص کنید، می‌توانید پارامتر سیستمfields را تنظیم کنید. اگر پارامتر fields را مشخص نکنید، سرور یک مجموعه پیش‌فرض از فیلدها را برمی‌گرداند. برای اطلاعات بیشتر، به قسمت‌های خاص بازگشت مراجعه کنید.
نمونه کد زیر نحوه بازگرداندن لیستی از تمام برنامه های نصب شده کاربر را در درخواست نشان می دهد. پاسخ مقادیر فیلد درخواست را برمی گرداند.
برای پیدا کردن یک برنامه خاص، از یک یا چند پارامتر درخواست اختیاری استفاده کنید:
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 یونیکد فیلتر کنید. نمونه‌هایی از کدهای زبان عبارتند از 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
تاریخ آخرین به‌روزرسانی 2025-09-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-09-01 بهوقت ساعت هماهنگ جهانی."],[],[],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)."]]
