رابط برنامهنویسی کاربردی گزارشها (Reports API) شما را قادر میسازد گزارشهایی ایجاد کنید که اطلاعات کلی در مورد دستگاه مدیریتشدهی ChromeOS / مرورگر Chrome شما ارائه میدهند.
مرور سریع متدهای API
آدرسهای اینترنتی (URL) نسبت به https://chromemanagement.googleapis.com/v1/customers/ $CUSTOMER هستند.
| توضیحات | آدرس اینترنتی نسبی | روش اچتیپی | پارامترهای درخواست مجاز |
|---|---|---|---|
| تعداد مرورگرهای کروم که در دامنه شما نیاز به توجه دارند را بشمارید | /گزارشها:countChromeBrowsersNeedingAttention | دریافت کنید | اختیاری : شناسه واحد سازمانی |
| تعداد دستگاههای Chrome که به تاریخ انقضای خودکار در دامنه شما میرسند را بشمارید. | /گزارشها:countChromeDevicesReachingAutoExpirationDate | دریافت کنید | اختیاری : orgUnitId، minAueDate، maxAueDate |
| تعداد دستگاههای کرومی که در دامنه شما نیاز به توجه دارند را بشمارید | /گزارشها:countChromeDevicesThatNeedAttention | دریافت کنید | اختیاری : orgUnitId، readMask |
| تعداد دستگاههای ناوگان سختافزاری Chrome را در دامنه خود بشمارید | /گزارشها:countChromeHardwareFleetDevices | دریافت کنید | اختیاری : orgUnitId، readMask |
| تعداد نسخههای کروم نصبشده روی دستگاههای دامنه شما | /گزارشها:countChromeVersions | دریافت کنید | اختیاری : orgUnitId، filter، pageSize، pageToken |
| تعداد برنامههای نصبشدهی گزارششده در دستگاهها و مرورگرهای شما را بشمارید | /گزارشها:countInstalledApps | دریافت کنید | اختیاری : orgUnitId، filter، pageSize، pageToken، orderBy |
| خلاصهای از چاپهای انجام شده توسط هر چاپگر در دامنه خود را دریافت کنید | /گزارشها:countPrintJobsByPrinter | دریافت کنید | اختیاری : printerOrgUnitId، filter، pageSize، pageToken، orderBy |
| خلاصهای از چاپهای انجام شده توسط هر کاربر در دامنه خود را دریافت کنید | /گزارشها:countPrintJobsByUser | دریافت کنید | اختیاری : printerOrgUnitId، filter، pageSize، pageToken، orderBy |
| گزارش دقیقی از کارهای چاپی در دامنه خود دریافت کنید | /گزارشها: enumeratePrintJobs | دریافت کنید | اختیاری : printerOrgUnitId، filter، pageSize، pageToken، orderBy |
| فهرست کردن دستگاههایی که یک برنامه خاص روی آنها نصب شده است | /گزارشها: findInstalledAppDevices | دریافت کنید | اختیاری : orgUnitId، filter، pageSize، pageToken، orderBy |
| فهرست کردن پروفایلهایی که یک برنامه خاص روی آنها نصب شده است | /گزارشها:findInstalledAppProfiles | دریافت کنید | اختیاری : orgUnitId، filter، pageSize، pageToken، orderBy |
| تعداد رویدادهای خرابی کروم را دریافت کنید | /گزارشها:countChromeCrashEvents | دریافت کنید | اختیاری : orgUnitId، filter، orderBy |
برای مثال، نمونه کدها را برای درخواستها و پاسخها ببینید.
امتیازات مدیر
API گزارشها به واگذاری نقش مدیر احترام میگذارد. بسته به اینکه مدیر میخواهد چه گزارشهایی تولید کند، امتیازات مدیریتی متفاوتی مورد نیاز است.
| روش | امتیازات مدیریتی مورد نیاز است |
|---|---|
| تعداد مرورگرهای کرومنیازمند توجه | «سرویسها -> مدیریت کروم -> مشاهده گزارش بینشهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش بینشهای Chrome» |
| تعداد دستگاههای کروم در حال رسیدن به تاریخ انقضای خودکار | «سرویسها -> مدیریت کروم -> مشاهده گزارش بینشهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش بینشهای Chrome» |
| تعداد دستگاههای کروم که به توجه نیاز دارند | «سرویسها -> مدیریت کروم -> مشاهده گزارش بینشهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش بینشهای Chrome» |
| تعداد کرومسختافزارناوگاندستگاهها | «سرویسها -> مدیریت کروم -> مشاهده گزارش بینشهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش بینشهای Chrome» |
| تعدادنسخههای کروم | «سرویسها -> مدیریت کروم -> مشاهده گزارش نسخههای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش نسخههای Chrome» |
| تعداد برنامههای نصبشده | «سرویسها -> مدیریت کروم -> مشاهده گزارش فهرست افزونهها» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش فهرست افزونهها» |
| countPrintJobsByPrinter | «سرویسها -> مدیریت کروم -> مشاهده گزارش چاپگرهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش چاپگرهای Chrome» |
| countPrintJobsByUser | «سرویسها -> مدیریت کروم -> مشاهده گزارش چاپگرهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش چاپگرهای Chrome» |
| enumeratePrintJobs | «سرویسها -> مدیریت کروم -> مشاهده گزارش چاپگرهای کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش چاپگرهای Chrome» |
| پیدا کردن دستگاههای برنامه نصبشده | «سرویسها -> مدیریت کروم -> مشاهده گزارش فهرست افزونهها» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش فهرست افزونهها» |
| پیدا کردن پروفایلهای برنامههای نصبشده | «سرویسها -> مدیریت کروم -> مشاهده گزارش فهرست افزونهها» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش فهرست افزونهها» |
| countChromeCrashEvents | «سرویسها -> مدیریت کروم -> مشاهده گزارش خرابی کروم» یا «سرویسها -> ChromeOS -> تنظیمات -> مشاهده گزارش خرابی کروم» |
برای مدیریت نقشها و امتیازات مدیر، به «کنسول مدیریت -> نقشهای مدیر» مراجعه کنید.
دامنههای API
API گزارشها به محدوده OAuth زیر نیاز دارد:
https://www.googleapis.com/auth/chrome.management.reports.readonly
برای اطلاعات بیشتر، به مرور کلی احراز هویت مراجعه کنید.