reportRoot: getOffice365GroupsActivityDetail
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta
de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Obtenga detalles sobre la actividad de grupos de Microsoft 365 por grupo.
Nota: Para obtener más información sobre diferentes vistas y nombres de informe, consulte Informes de Microsoft 365: grupos de Microsoft 365.
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 haber asignado al usuario el rol de administrador limitado id. de Microsoft Entra 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/getOffice365GroupsActivityDetail(period='{period_value}')
GET /reports/getOffice365GroupsActivityDetail(date={date_value})
Parámetros de función
En la URL de la solicitud, especifique uno de los parámetros siguientes con un valor válido.
Parámetro | Tipo | Descripción |
---|---|---|
period | cadena | Especifica la duración de tiempo durante la que se agrega el informe. Los valores admitidos para {period_value} son: D7, D30, D90 y D180. Estos valores tienen el formato Dn, donde n representa el número de días durante los que se agrega el informe. |
date | Fecha | Especifica la fecha en que quiere ver los usuarios que realizaron alguna actividad. {date_value} necesita tener el formato de AAAA-MM-DD. Como este informe solo está disponible para los últimos 30 días, {date_value} tiene que ser una fecha de ese intervalo. |
Nota: Necesita establecer un período o una fecha en la URL.
Este método admite los $format
parámetros de consulta , $top
y $skipToken
OData para personalizar la respuesta. El tipo de salida predeterminado es text/csv. Sin embargo, si desea especificar el tipo de salida, puede usar el parámetro de consulta OData $format establecido en text/csv o application/json.
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Respuesta
CSV
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
- Nombre para mostrar del grupo
- Eliminado
- Nombre principal de propietario
- Fecha de la última actividad
- Tipo de grupo
- Número de miembros
- Número de miembros externos
- Número de correos electrónicos recibidos de Exchange
- Número de archivos activos de SharePoint
- Número de mensajes publicados en Yammer
- Número de mensajes leídos en Yammer
- Número de mensajes etiquetados como “Me gusta” en Yammer
- Recuento de mensajes de canal de Teams
- Recuento organizado de reuniones de Teams
- Número total de elementos de buzones de Exchange
- Almacenamiento usado de buzones de Exchange (bytes)
- Número total de archivos de SharePoint
- Almacenamiento usado de sitios de SharePoint (bytes)
- Id. de grupo
- Período del informe
Las columnas siguientes no se admiten en Microsoft Graph China operado por 21Vianet:
- Número de mensajes publicados en Yammer
- Número de mensajes leídos en Yammer
- Número de mensajes etiquetados como “Me gusta” en Yammer
- Recuento de mensajes de canal de Teams
- Recuento organizado de reuniones de Teams
JSON
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto office365GroupsActivityDetail en el cuerpo de la respuesta.
Las siguientes propiedades del objeto office365GroupsActivityDetail no se admiten en Microsoft Graph China operado por 21Vianet:
- yammerPostedMessageCount
- yammerReadMessageCount
- yammerLikedMessageCount
- teamsChannelMessagesCount
- teamsMeetingsOrganizedCount
El tamaño de página predeterminado para esta solicitud es de 200 elementos.
Ejemplo
CSV
Este es un ejemplo que genera CSV.
Solicitud
Este es un ejemplo de la solicitud.
GET https://graph.microsoft.com/beta/reports/getOffice365GroupsActivityDetail(period='D7')?$format=text/csv
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 que descarga tiene el siguiente esquema.
HTTP/1.1 200 OK
Content-Type: application/octet-stream
Report Refresh Date,Group Display Name,Is Deleted,Owner Principal Name,Last Activity Date,Group Type,Member Count,External Member Count,Exchange Received Email Count,SharePoint Active File Count,Yammer Posted Message Count,Yammer Read Message Count,Yammer Liked Message Count,Teams Channel Messages Count,Teams Meetings Organized Count,Exchange Mailbox Total Item Count,Exchange Mailbox Storage Used (Byte),SharePoint Total File Count,SharePoint Site Storage Used (Byte),Group Id,Report Period
JSON
Este es un ejemplo que devuelve JSON.
Solicitud
Este es un ejemplo de la solicitud.
GET https://graph.microsoft.com/beta/reports/getOffice365GroupsActivityDetail(period='D7')?$format=application/json
Respuesta
Este es un ejemplo de la respuesta:
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 674
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(microsoft.graph.office365GroupsActivityDetail)",
"value": [
{
"groupId": "0003cf63-7ff3-4471-b24b-50ffbfb8b5d2",
"reportRefreshDate": "2017-09-01",
"groupDisplayName": "groupDisplayName-value",
"isDeleted": false,
"ownerPrincipalName": "ownerDisplayName-value",
"lastActivityDate": "2017-08-31",
"groupType": "Private",
"memberCount": 5,
"externalMemberCount": 0,
"exchangeReceivedEmailCount": 341,
"sharePointActiveFileCount": 0,
"yammerPostedMessageCount": 0,
"yammerReadMessageCount": 0,
"yammerLikedMessageCount": 0,
"teamsChannelMessagesCount": 0,
"teamsMeetingsOrganizedCount": 0,
"exchangeMailboxTotalItemCount": 343,
"exchangeMailboxStorageUsedInBytes": 3724609,
"sharePointTotalFileCount": 0,
"sharePointSiteStorageUsedInBytes": 0,
"reportPeriod": "30"
}
]
}