عرض معلومات المستخدم
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوفّر Google Drive خيارَين لجمع معلومات حول مستخدمي Drive:
باستخدام مورد about، يمكنك استرداد معلومات حول المستخدم وإعدادات Drive الخاصة به وإمكانات النظام.
باستخدام مورد apps، يمكنك استرداد قائمة بالتطبيقات المثبَّتة على جهاز المستخدم، مع معلومات حول أنواع MIME وملحقات الملفات المتوافقة مع كل تطبيق وتفاصيل أخرى.
يشرح هذا الدليل كيفية استرداد معلومات المستخدم في Drive.
الحصول على تفاصيل حول مستخدم
لعرض معلومات عن مستخدم Drive كنموذج من about، استخدِم طريقة get. يتم قياس القيم التي يتم إرجاعها بالبايت.
يجب ضبط fields المَعلمة system في طريقة get لتحديد الحقول التي سيتم عرضها في الاستجابة. في معظم طرق 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" أو إضافة مستخدَمة في "مستندات Google" لتوقيع المستندات. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام تطبيقات Google Drive.
لعرض قائمة بجميع التطبيقات المثبَّتة لدى المستخدم كنموذج من apps، استخدِم طريقة list بدون أي مَعلمات.
إذا أردت تحديد الحقول التي سيتم عرضها في الرد، يمكنك ضبط المَعلمة fields system. في حال عدم تحديد المَعلمة 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" وapplication/vnd.google-apps.site لـ "مواقع Google". للاطّلاع على المزيد من الأمثلة على أنواع 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 (حسب التوقيت العالمي المتفَّق عليه)
[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)."]]
