reportRoot: getOffice365ActivationsUserCounts
Espacio de nombres: microsoft.graph
Obtenga el recuento de usuarios habilitados y los que activaron la suscripción de Office en equipos de escritorio, dispositivos o compartidos.
Nota: Para obtener más información sobre diferentes vistas y nombres de informe, consulte Informes de Microsoft 365: activaciones de Microsoft Office.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | Reports.Read.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | Reports.Read.All | No disponible. |
Nota: Para que los permisos delegados permitan a las aplicaciones leer informes de uso del servicio en nombre de un usuario, el administrador de inquilinos debe asignar al usuario el rol de administrador Microsoft Entra limitado adecuado. Para obtener más información, consulte Autorización para que las API lean los informes de uso de Microsoft 365.
Solicitud HTTP
GET /reports/getOffice365ActivationsUserCounts
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| If-None-Match | Si se incluye el encabezado de la solicitud y la eTag proporcionada coincide con la etiqueta actual del archivo, se devuelve un código de respuesta 304 Not Modified. Opcional. |
Respuesta
Si se ejecuta correctamente, este método devuelve una respuesta 302 Found que redirige a una URL de descarga con autenticación previa para el informe. La URL se encuentra en el encabezado Location de la respuesta.
Las direcciones URL de descarga autenticadas previamente solo son válidas durante un breve período de tiempo (unos minutos) y no requieren un Authorization encabezado.
El archivo CSV tiene los siguientes encabezados de columna.
- Fecha de actualización del informe
- Tipo de producto
- Asignado
- Activated
- Activación del equipo compartido
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserCounts
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 302 Found
Content-Type: text/plain
Location: http://222.178.203.72:19005/whst/63/=qdonqsrzneehbdzbnl//data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
Siga el redireccionamiento 302 y el archivo CSV que descarga contiene el esquema siguiente.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Report Refresh Date,Product Type,Assigned,Activated,Shared Computer Activation