Method: apps.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
درخواست HTTP
GET https://www.googleapis.com/drive/v3/apps
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
appFilterExtensions | string فهرستی از پسوندهای فایل جدا شده با کاما برای محدود کردن نتایج بازگشتی. تمام نتایج در محدوده پرس و جو برنامه داده شده که می تواند هر یک از پسوندهای فایل داده شده را باز کند در پاسخ گنجانده شده است. اگر appFilterMimeTypes نیز ارائه شده باشد، نتیجه اتحاد دو لیست برنامه به دست آمده است. |
appFilterMimeTypes | string فهرستی از پسوندهای فایل جدا شده با کاما برای محدود کردن نتایج بازگشتی. تمام نتایج در محدوده پرس و جو برنامه داده شده که می تواند هر یک از انواع MIME داده شده را باز کند در پاسخ گنجانده می شود. اگر appFilterExtensions نیز ارائه شده باشد، نتیجه اتحاد دو لیست برنامه به دست آمده است. |
languageCode | string یک زبان یا کد محلی، همانطور که توسط BCP 47 تعریف شده است، با برخی پسوندها از قالب LDML یونیکد ( 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]