reportRoot: getYammerGroupsActivityDetail
Espacio de nombres: microsoft.graph
Obtiene información sobre la actividad de grupos de Yammer por grupo.
Nota: Para obtener más información sobre diferentes vistas y nombres de informe, consulte Informes de Microsoft 365: actividad de grupos de Yammer.
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 adecuado Microsoft Entra ID. Para obtener más información, vea Autorización para que las API lean informes de uso de Microsoft 365.
Solicitud HTTP
GET /reports/getYammerGroupsActivityDetail(period='{period_value}')
GET /reports/getYammerGroupsActivityDetail(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.
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 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 para mostrar del grupo
- Eliminado
- Nombre principal de propietario
- Fecha de la última actividad
- Tipo de grupo
- Office 365 conectado
- Número de miembros
- Número de publicaciones
- Número de lecturas
- Número de etiquetados como “Me gusta”
- Período del informe
Ejemplos
Ejemplo 1: getYammerGroupsActivityDetail por punto
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/reports/getYammerGroupsActivityDetail(period='D7')
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 302 Found
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
Ejemplo 2: getYammerGroupsActivityDetail por fecha
Solicitud
Si se llama a con , date
el informe se limita a la actividad en la fecha especificada.
GET https://graph.microsoft.com/v1.0/reports/getYammerGroupsActivityDetail(date='2018-03-05')
Respuesta
En el ejemplo siguiente se muestra 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,Group Display Name,Is Deleted,Owner Principal Name,Last Activity Date,Group Type,Office 365 Connected,Member Count,Posted Count,Read Count,Liked Count,Report Period