reportRoot: getYammerGroupsActivityDetail

Artículo
10/31/2023

Espacio de nombres: microsoft.graph

Obtiene información sobre la actividad de grupos de Yammer por grupo.

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.

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')


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Reports.GetYammerGroupsActivityDetailWithPeriod("{period}").GetAsync();



mgc reports get-yammer-groups-activity-detail-with-period get --period {period-id}



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
period := "{period}"
graphClient.Reports().GetYammerGroupsActivityDetailWithPeriod(&period).Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.reports().getYammerGroupsActivityDetailWithPeriod("{period}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/reports/getYammerGroupsActivityDetail(period='D7')')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->reports()->getYammerGroupsActivityDetailWithPeriod('{period}', )->get()->wait();

Snippet not available


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.reports.get_yammer_groups_activity_detail_with_period("{period}").get()

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 , dateel informe se limita a la actividad en la fecha especificada.

GET https://graph.microsoft.com/v1.0/reports/getYammerGroupsActivityDetail(date='2018-03-05')


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Reports.GetYammerGroupsActivityDetailWithDate(new Date(DateTime.Parse("{date}"))).GetAsync();



mgc reports get-yammer-groups-activity-detail-with-date get --date {date-id}



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
date := {date}
graphClient.Reports().GetYammerGroupsActivityDetailWithDate(&date).Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.reports().getYammerGroupsActivityDetailWithDate(LocalDate.parse("{date}")).get();

Snippet not available


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->reports()->getYammerGroupsActivityDetailWithDate(new Date('{date}'))->get()->wait();


Import-Module Microsoft.Graph.Reports

Get-MgReportYammerGroupActivityDetail


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.reports.get_yammer_groups_activity_detail_with_date("{date}").get()

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

Compartir a través de

reportRoot: getYammerGroupsActivityDetail

Permissions

Solicitud HTTP

Parámetros de función

Encabezados de solicitud

Respuesta

Ejemplos

Ejemplo 1: getYammerGroupsActivityDetail por punto

Solicitud

Respuesta

Ejemplo 2: getYammerGroupsActivityDetail por fecha

Solicitud

Respuesta

Comentarios

Recursos adicionales