Method: apps.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الطريقة قائمة بالتطبيقات المثبَّتة لدى المستخدم. لمزيد من المعلومات، اطّلِع على عرض معلومات المستخدم.
طلب HTTP
GET https://www.googleapis.com/drive/v3/apps
يستخدِم عنوان URL بنية تحويل الترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
appFilterExtensions |
string
قائمة مفصولة بفواصل تضمّ امتدادات الملفات التي يجب حصر النتائج المعروضة بها. يتم تضمين جميع النتائج ضمن نطاق طلب البحث في التطبيق المحدّد والتي يمكنها فتح أي من امتدادات الملفات المحدّدة في الردّ. في حال توفير appFilterMimeTypes أيضًا، ستكون النتيجة عبارة عن اتحاد لقائمتَي التطبيقات الناتجتَين.
|
appFilterMimeTypes |
string
قائمة مفصولة بفواصل تضمّ امتدادات الملفات التي يجب حصر النتائج المعروضة بها. سيتم تضمين جميع النتائج ضمن نطاق طلب البحث في التطبيق المحدّد والتي يمكنها فتح أي من أنواع MIME المحدّدة في الردّ. في حال توفير appFilterExtensions أيضًا، ستكون النتيجة عبارة عن اتحاد لقائمتَي التطبيقات الناتجتَين.
|
languageCode |
string
رمز لغة أو رمز إعدادات محلية، كما هو محدّد في BCP 47، مع بعض الإضافات من تنسيق LDML الخاص بـ Unicode (http://www.unicode.org/reports/tr35/)
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بالتطبيقات التابعة لجهات خارجية التي ثبّتها المستخدم أو منحها إذن الوصول إلى Google Drive
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"defaultAppIds": [
string
],
"items": [
{
object (App)
}
],
"kind": string,
"selfLink": string
} |
| الحقول |
defaultAppIds[] |
string
قائمة بمعرّفات التطبيقات التي حدّدها المستخدم لاستخدامها تلقائيًا. تظهر القائمة بترتيب الأولوية العكسي (من الأدنى إلى الأعلى).
|
items[] |
object (App)
قائمة التطبيقات
|
kind |
string
النتائج فقط. تحدّد نوع المورد. القيمة: السلسلة الثابتة "drive#appList".
|
selfLink |
string
رابط يؤدي إلى هذه القائمة
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/drive.apps.readonly
بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتتمكّن من استخدامها في تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: apps.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AppList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a user's installed apps. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info).\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/apps`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `appFilterExtensions` | `string` A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given file extensions are included in the response. If `appFilterMimeTypes` are provided as well, the result is a union of the two resulting app lists. |\n| `appFilterMimeTypes` | `string` A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given MIME types will be included in the response. If `appFilterExtensions` are provided as well, the result is a union of the two resulting app lists. |\n| `languageCode` | `string` A language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (\u003chttp://www.unicode.org/reports/tr35/)\u003e. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of third-party applications which the user has installed or given access to Google Drive.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"defaultAppIds\": [ string ], \"items\": [ { object (/workspace/drive/api/reference/rest/v3/apps#App) } ], \"kind\": string, \"selfLink\": string } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `defaultAppIds[]` | `string` The list of app IDs that the user has specified to use by default. The list is in reverse-priority order (lowest to highest). |\n| `items[]` | `object (`[App](/workspace/drive/api/reference/rest/v3/apps#App)`)` The list of apps. |\n| `kind` | `string` Output only. Identifies what kind of resource this is. Value: the fixed string \"drive#appList\". |\n| `selfLink` | `string` A link back to this list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/drive.apps.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
