L'API Reports vous permet de générer des rapports qui fournissent des informations agrégées sur votre déploiement d'appareils ChromeOS gérés et de navigateurs Chrome.
Présentation rapide des méthodes d'API
Les URL sont relatives à https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| Description | URL relative | Méthode HTTP | Paramètres de requête autorisés |
|---|---|---|---|
| Compter les navigateurs Chrome nécessitant une attention particulière dans votre domaine | /reports:countChromeBrowsersNeedingAttention | GET | Facultatif : orgUnitId |
| Compter les appareils Chrome atteignant leur date d'expiration automatique dans votre domaine | /reports:countChromeDevicesReachingAutoExpirationDate | GET | Facultatif : orgUnitId, minAueDate, maxAueDate |
| Compter les appareils Chrome nécessitant une attention particulière dans votre domaine | /reports:countChromeDevicesThatNeedAttention | GET | Facultatif : orgUnitId, readMask |
| Compter les appareils Chrome de votre parc matériel dans votre domaine | /reports:countChromeHardwareFleetDevices | GET | Facultatif : orgUnitId, readMask |
| Compter les versions de Chrome déployées sur les profils de votre domaine | /reports:countChromeProfileVersions | GET | Facultatif : orgUnitId, filter, pageSize, pageToken |
| Compter les versions de Chrome déployées sur les appareils de votre domaine | /reports:countChromeVersions | GET | Facultatif : orgUnitId, filter, pageSize, pageToken |
| Compter les applications signalées comme installées sur vos appareils et navigateurs | /reports:countInstalledApps | GET | Facultatif : orgUnitId, filter, pageSize, pageToken, orderBy |
| Obtenir un résumé des impressions effectuées par chaque imprimante de votre domaine | /reports:countPrintJobsByPrinter | GET | Facultatif : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Obtenir un résumé des impressions effectuées par chaque utilisateur de votre domaine | /reports:countPrintJobsByUser | GET | Facultatif : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Obtenir un rapport détaillé sur les tâches d'impression dans votre domaine | /reports:enumeratePrintJobs | GET | Facultatif : printerOrgUnitId, filter, pageSize, pageToken, orderBy |
| Lister les appareils sur lesquels une application particulière est installée | /reports:findInstalledAppDevices | GET | Facultatif : orgUnitId, filter, pageSize, pageToken, orderBy |
| Lister les profils sur lesquels une application particulière est installée | /reports:findInstalledAppProfiles | GET | Facultatif : orgUnitId, filter, pageSize, pageToken, orderBy |
| Obtenir le nombre d'événements de plantage de Chrome | /reports:countChromeCrashEvents | GET | Facultatif : orgUnitId, filter, orderBy |
| Rechercher des rapports sur l'utilisation du SaaS dans votre domaine | /reports:findSaasUsage | GET | Facultatif : filter, pageSize, pageToken, orderBy |
| Rechercher des rapports sur l'utilisation du SaaS dans votre domaine, regroupés par navigateur | /reports:findSaasUsageBrowsers | GET | Obligatoire : app ; Facultatif : filter, pageSize, pageToken, orderBy |
| Rechercher des rapports sur l'utilisation du SaaS dans votre domaine, regroupés par profil | /reports:findSaasUsageProfiles | GET | Obligatoire : app ; Facultatif : filter, pageSize, pageToken, orderBy |
Consultez des exemples de requêtes et de réponses dans les exemples de code.
Droits d'administrateur
L'API Reports respecte la délégation des rôles d'administrateur. Selon les rapports que l'administrateur souhaite générer, différents droits d'administrateur sont requis.
| Méthode | Droits d'administrateur requis |
|---|---|
| countChromeBrowsersNeedingAttention | "Services -> Gestion de Chrome -> Afficher le rapport Chrome Insights"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport Chrome Insights" |
| countChromeDevicesReachingAutoExpirationDate | "Services -> Gestion de Chrome -> Afficher le rapport Chrome Insights"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport Chrome Insights" |
| countChromeDevicesThatNeedAttention | "Services -> Gestion de Chrome -> Afficher le rapport Chrome Insights"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport Chrome Insights" |
| countChromeHardwareFleetDevices | "Services -> Gestion de Chrome -> Afficher le rapport Chrome Insights"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport Chrome Insights" |
| countChromeProfileVersions | "Services -> Gestion de Chrome -> Afficher le rapport sur les versions de Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les versions de Chrome" |
| countChromeVersions | "Services -> Gestion de Chrome -> Afficher le rapport sur les versions de Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les versions de Chrome" |
| countInstalledApps | "Services -> Gestion de Chrome -> Afficher le rapport sur la liste des extensions"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur la liste des extensions" |
| countPrintJobsByPrinter | "Services -> Gestion de Chrome -> Afficher le rapport sur les imprimantes Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les imprimantes Chrome" |
| countPrintJobsByUser | "Services -> Gestion de Chrome -> Afficher le rapport sur les imprimantes Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les imprimantes Chrome" |
| enumeratePrintJobs | "Services -> Gestion de Chrome -> Afficher le rapport sur les imprimantes Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les imprimantes Chrome" |
| findInstalledAppDevices | "Services -> Gestion de Chrome -> Afficher le rapport sur la liste des extensions"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur la liste des extensions" |
| findInstalledAppProfiles | "Services -> Gestion de Chrome -> Afficher le rapport sur la liste des extensions"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur la liste des extensions" |
| countChromeCrashEvents | "Services -> Gestion de Chrome -> Afficher le rapport sur les plantages de Chrome"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur les plantages de Chrome" |
| findSaasUsage | "Services -> Gestion de Chrome -> Afficher le rapport sur l'utilisation du SaaS"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur l'utilisation du SaaS" |
| findSaasUsageBrowsers | "Services -> Gestion de Chrome -> Afficher le rapport sur l'utilisation du SaaS"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur l'utilisation du SaaS" |
| findSaasUsageProfiles | "Services -> Gestion de Chrome -> Afficher le rapport sur l'utilisation du SaaS"
ou "Services -> ChromeOS -> Paramètres -> Afficher le rapport sur l'utilisation du SaaS" |
Pour gérer les rôles et les droits d'administrateur, accédez à "Console d'administration -> Rôles d'administrateur".
Champs d'application de l'API
L'API Reports requiert le champ d'application OAuth suivant :
https://www.googleapis.com/auth/chrome.management.reports.readonly
Pour en savoir plus, consultez la page Présentation de l'authentification.