Admin SDK: Reports API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Admin SDK Reports API به مدیران دامنه های سازمانی اجازه می دهد تا گزارش های حسابرسی و استفاده از دامنه خود را مشاهده کنند.
خدمات: admin.googleapis.com
برای تماس با این سرویس، توصیه می کنیم از کتابخانه های سرویس گیرنده ارائه شده توسط Google استفاده کنید. اگر برنامه شما نیاز به استفاده از کتابخانه های خود برای فراخوانی این سرویس دارد، هنگام درخواست API از اطلاعات زیر استفاده کنید.
سند کشف
Discovery Document یک ویژگی قابل خواندن توسط ماشین برای توصیف و مصرف API های REST است. از آن برای ساخت کتابخانه های سرویس گیرنده، پلاگین های IDE و سایر ابزارهایی که با Google API در تعامل هستند استفاده می شود. یک سرویس ممکن است چندین سند کشف را ارائه دهد. این سرویس سند کشف زیر را ارائه می دهد:
نقطه پایان خدمات
نقطه پایانی سرویس یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و همه URI های زیر مربوط به این نقطه پایانی سرویس هستند:
-
https://admin.googleapis.com
| روش ها |
|---|
list | GET /admin/reports/v1/activity/users/{userKey}/applications/{applicationName}
فهرستی از فعالیت‌ها را برای حساب و برنامه یک مشتری خاص مانند برنامه کنسول Admin یا برنامه Google Drive بازیابی می‌کند. |
watch | POST /admin/reports/v1/activity/users/{userKey}/applications/{applicationName}/watch
شروع به دریافت اعلان برای فعالیت های حساب کنید. |
| روش ها |
|---|
get | GET /admin/reports/v1/usage/dates/{date}
گزارشی را بازیابی می کند که مجموعه ای از خواص و آمار برای حساب یک مشتری خاص است. |
| روش ها |
|---|
get | GET /admin/reports/v1/usage/{entityType}/{entityKey}/dates/{date}
گزارشی را بازیابی می کند که مجموعه ای از ویژگی ها و آمار موجودیت هایی است که توسط کاربران در حساب کاربری استفاده می شود. |
| روش ها |
|---|
get | GET /admin/reports/v1/usage/users/{userKey}/dates/{date}
گزارشی را بازیابی می کند که مجموعه ای از ویژگی ها و آمار برای مجموعه ای از کاربران دارای حساب است. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Admin SDK: Reports API\n\nThe **Admin SDK Reports API** lets administrators of enterprise domains to view the audit and usage reports of their domain.\n\n- [REST Resource: activities](#activities)\n- [REST Resource: customerUsageReports](#customerUsageReports)\n- [REST Resource: entityUsageReports](#entityUsageReports)\n- [REST Resource: userUsageReport](#userUsageReport)\n\nService: admin.googleapis.com\n-----------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://admin.googleapis.com/$discovery/rest?version=reports_v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://admin.googleapis.com`\n\nREST Resource: [activities](/workspace/admin/reports/reference/rest/v1/activities)\n----------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [list](/workspace/admin/reports/reference/rest/v1/activities/list) | `GET /admin/reports/v1/activity/users/{userKey}/applications/{applicationName}` Retrieves a list of activities for a specific customer's account and application such as the Admin console application or the Google Drive application. |\n| [watch](/workspace/admin/reports/reference/rest/v1/activities/watch) | `POST /admin/reports/v1/activity/users/{userKey}/applications/{applicationName}/watch` Start receiving notifications for account activities. |\n\nREST Resource: [customerUsageReports](/workspace/admin/reports/reference/rest/v1/customerUsageReports)\n------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/admin/reports/reference/rest/v1/customerUsageReports/get) | `GET /admin/reports/v1/usage/dates/{date}` Retrieves a report which is a collection of properties and statistics for a specific customer's account. |\n\nREST Resource: [entityUsageReports](/workspace/admin/reports/reference/rest/v1/entityUsageReports)\n--------------------------------------------------------------------------------------------------\n\n| Methods ||\n|--------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/admin/reports/reference/rest/v1/entityUsageReports/get) | `GET /admin/reports/v1/usage/{entityType}/{entityKey}/dates/{date}` Retrieves a report which is a collection of properties and statistics for entities used by users within the account. |\n\nREST Resource: [userUsageReport](/workspace/admin/reports/reference/rest/v1/userUsageReport)\n--------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/workspace/admin/reports/reference/rest/v1/userUsageReport/get) | `GET /admin/reports/v1/usage/users/{userKey}/dates/{date}` Retrieves a report which is a collection of properties and statistics for a set of users with the account. |"]]
