reportRoot: getOffice365ActivationsUserDetail

  • Artículo

Espacio de nombres: microsoft.graph

Obtenga detalles sobre los usuarios que han activado Microsoft 365.

Nota: Para obtener más información sobre diferentes vistas y nombres de informe, consulte Informes de Microsoft 365: activaciones de Microsoft Office.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Reports.Read.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación Reports.Read.All

Nota: Para permisos delegados a fin de permitir que las aplicaciones lean los informes de uso del servicio en nombre de un usuario, el administrador de la cuenta empresarial debe haber asignado al usuario un rol de administrador limitado apropiado en Azure AD. Para obtener más información, vea Autorización para que las API lean informes de uso de Microsoft 365.

Solicitud HTTP

GET /reports/getOffice365ActivationsUserDetail

Encabezados de solicitud

Nombre Descripción
Authorization Portador {token}. Obligatorio.
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 URL de descarga con autenticación previa solo son válidas durante un breve período de tiempo (unos minutos) y no necesitan un encabezado Authorization para descargarlas.

El archivo CSV tiene los siguientes encabezados de columna.

  • Fecha de actualización del informe
  • Nombre principal de usuario
  • Nombre para mostrar
  • Tipo de producto
  • Fecha de la última activación
  • Windows
  • Mac
  • Windows 10 Mobile
  • iOS
  • Android
  • Activado en el equipo compartido

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

GET https://graph.microsoft.com/v1.0/reports/getOffice365ActivationsUserDetail

Respuesta

Este es un ejemplo de la respuesta.

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Siga el redireccionamiento 302 y el archivo CSV descargado tendrá el esquema siguiente.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Product Type,Last Activated Date,Windows,Mac,Windows 10 Mobile,iOS,Android,Activated On Shared Computer