L'API Reports consente di generare report che forniscono informazioni aggregate sul deployment del browser Chrome / dei dispositivi ChromeOS gestiti.
Panoramica rapida dei metodi API
Gli URL sono relativi a https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Descrizione | URL relativo | Metodo HTTP | Parametri di richiesta consentiti |
|---|---|---|---|
| Conta i browser Chrome che richiedono attenzione nel tuo dominio | /reports:countChromeBrowsersNeedingAttention | GET | Facoltativo: orgUnitId |
| Conta i dispositivi Chrome che stanno per raggiungere la data di scadenza degli aggiornamenti automatici nel tuo dominio | /reports:countChromeDevicesReachingAutoExpirationDate | GET | Facoltativo: orgUnitId, minAueDate, maxAueDate |
| Conta i dispositivi Chrome che richiedono attenzione nel tuo dominio | /reports:countChromeDevicesThatNeedAttention | GET | Facoltativo: orgUnitId, readMask |
| Conta i dispositivi del parco risorse hardware Chrome nel tuo dominio | /reports:countChromeHardwareFleetDevices | GET | Facoltativo: orgUnitId, readMask |
| Conta le versioni di Chrome di cui è stato eseguito il deployment nei profili del tuo dominio | /reports:countChromeProfileVersions | GET | Facoltativo: orgUnitId, filter, pageSize, pageToken |
| Conta le versioni di Chrome di cui è stato eseguito il deployment nei dispositivi del tuo dominio | /reports:countChromeVersions | GET | Facoltativo: orgUnitId, filter, pageSize, pageToken |
| Conta le app segnalate installate sui dispositivi e sui browser | /reports:countInstalledApps | GET | Facoltativo: orgUnitId, filter, pageSize, pageToken, orderBy |
| Ottieni un riepilogo delle stampe eseguite da ogni stampante nel tuo dominio | /reports:countPrintJobsByPrinter | GET | Facoltativo: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Ottieni un riepilogo delle stampe eseguite da ogni utente nel tuo dominio | /reports:countPrintJobsByUser | GET | Facoltativo: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Ottieni un report dettagliato dei job di stampa nel tuo dominio | /reports:enumeratePrintJobs | GET | Facoltativo: printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Elenca i dispositivi su cui è installata una determinata app | /reports:findInstalledAppDevices | GET | Facoltativo: orgUnitId, filter, pageSize, pageToken, orderBy |
| Elenca i profili su cui è installata una determinata app | /reports:findInstalledAppProfiles | GET | Facoltativo: orgUnitId, filter, pageSize, pageToken, orderBy |
| Ottieni un conteggio degli eventi di arresto anomalo di Chrome | /reports:countChromeCrashEvents | GET | Facoltativo: orgUnitId, filter, orderBy |
| Trova i report sull'utilizzo di SaaS nel tuo dominio | /reports:findSaasUsage | GET | Facoltativo: filter, pageSize, pageToken, orderBy |
| Trova i report sull'utilizzo di SaaS nel tuo dominio raggruppati per browser | /reports:findSaasUsageBrowsers | GET | Obbligatorio: app; facoltativo: filter, pageSize, pageToken, orderBy |
| Trova i report sull'utilizzo di SaaS nel tuo dominio raggruppati per profili | /reports:findSaasUsageProfiles | GET | Obbligatorio: app; Facoltativo: filter, pageSize, pageToken, orderBy |
Vedi esempi di codice per richieste e risposte di esempio.
Privilegi amministrativi
L'API Reports rispetta la delega dei ruoli amministrativi. A seconda dei report che l'amministratore vuole generare, sono necessari privilegi amministrativi diversi.
| Metodo | Privilegi amministrativi richiesti |
|---|---|
| countChromeBrowsersNeedingAttention | "Servizi -> Gestione di Chrome -> Visualizza report Statistiche di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Statistiche di Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "Servizi -> Gestione di Chrome -> Visualizza report Statistiche di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Statistiche di Chrome" |
| countChromeDevicesThatNeedAttention | "Servizi -> Gestione di Chrome -> Visualizza report Statistiche di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Statistiche di Chrome" |
| countChromeHardwareFleetDevices | "Servizi -> Gestione di Chrome -> Visualizza report Statistiche di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Statistiche di Chrome" |
| countChromeProfileVersions | "Servizi -> Gestione di Chrome -> Visualizza report Versioni di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Versioni di Chrome" |
| countChromeVersions | "Servizi -> Gestione di Chrome -> Visualizza report Versioni di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Versioni di Chrome" |
| countInstalledApps | "Servizi -> Gestione di Chrome -> Visualizza report Elenco estensioni"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Elenco estensioni" |
| countPrintJobsByPrinter | "Servizi -> Gestione di Chrome -> Visualizza report Stampanti Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Stampanti Chrome" |
| countPrintJobsByUser | "Servizi -> Gestione di Chrome -> Visualizza report Stampanti Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Stampanti Chrome" |
| enumeratePrintJobs | "Servizi -> Gestione di Chrome -> Visualizza report Stampanti Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Stampanti Chrome" |
| findInstalledAppDevices | "Servizi -> Gestione di Chrome -> Visualizza report Elenco estensioni"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Elenco estensioni" |
| findInstalledAppProfiles | "Servizi -> Gestione di Chrome -> Visualizza report Elenco estensioni"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Elenco estensioni" |
| countChromeCrashEvents | "Servizi -> Gestione di Chrome -> Visualizza report Arresto anomalo di Chrome"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report Arresto anomalo di Chrome" |
| findSaasUsage | "Servizi -> Gestione di Chrome -> Visualizza report sull'utilizzo di SaaS"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report sull'utilizzo di SaaS" |
| findSaasUsageBrowsers | "Servizi -> Gestione di Chrome -> Visualizza report sull'utilizzo di SaaS"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report sull'utilizzo di SaaS" |
| findSaasUsageProfiles | "Servizi -> Gestione di Chrome -> Visualizza report sull'utilizzo di SaaS"
o "Servizi -> ChromeOS -> Impostazioni -> Visualizza report sull'utilizzo di SaaS" |
Per gestire i ruoli e i privilegi amministrativi, vai a "Console di amministrazione -> Ruoli amministrativi".
Ambiti API
L'API Reports richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Per saperne di più, consulta la Panoramica dell'autenticazione.