reportRoot: getOffice365ActivationsUserDetailreportRoot: getOffice365ActivationsUserDetail

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Obtenga información sobre los usuarios que han activado Microsoft 365.Get details about users who have activated Microsoft 365.

Nota: Para obtener más información sobre los diferentes nombres de informes y vistas de informes, vea microsoft 365 Reports: activaciones de Microsoft Office.Note: For details about different report views and names, see Microsoft 365 reports - Microsoft Office activations.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Reports.Read.AllReports.Read.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication Reports.Read.AllReports.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.Note: For delegated permissions to allow apps to read service usage reports on behalf of a user, the tenant administrator must have assigned the user the appropriate Azure AD limited administrator role. Para obtener más información, vea autorización para API para leer informes de uso de Microsoft 365.For more details, see Authorization for APIs to read Microsoft 365 usage reports.

Solicitud HTTPHTTP request

GET /reports/getOffice365ActivationsUserDetail

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
If-None-MatchIf-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.If this request header is included and the eTag provided matches the current tag on the file, a 304 Not Modified response code is returned. Opcional.Optional.

RespuestaResponse

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.If successful, this method returns a 302 Found response that redirects to a preauthenticated download URL for the report. La URL se encuentra en el encabezado Location de la respuesta.That URL can be found in the Location header in the response.

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.Preauthenticated download URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header.

El archivo CSV tiene los siguientes encabezados de columna.The CSV file has the following headers for columns.

  • Fecha de actualización del informeReport Refresh Date
  • Nombre principal de usuarioUser Principal Name
  • Nombre para mostrarDisplay Name
  • Tipo de productoProduct Type
  • Fecha de la última activaciónLast Activated Date
  • WindowsWindows
  • MacMac
  • Windows 10 MobileWindows 10 Mobile
  • iOSiOS
  • AndroidAndroid
  • Activado en el equipo compartidoActivated On Shared Computer

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request.

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

RespuestaResponse

Este es un ejemplo de la respuesta.The following is an example of the response.

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.Follow the 302 redirection and the CSV file that downloads will have the following schema.

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