reportRoot: getTeamsTeamActivityDetail

Namespace: microsoft.graph

Obtenha detalhes sobre a atividade do Microsoft Teams por equipa. Os números incluem atividades para utilizadores licenciados e não licenciados.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Nota: Para permissões delegadas para permitir que as aplicações leiam relatórios de utilização do serviço em nome de um utilizador, o administrador inquilino deve ter atribuído ao utilizador a função de administrador Microsoft Entra ID limitada adequada. Para obter mais informações, veja Autorização para APIs para ler relatórios de utilização do Microsoft 365.

Solicitação HTTP

GET /reports/getTeamsTeamActivityDetail(period='{period_value}')

Parâmetros de função

No URL do pedido, forneça os seguintes parâmetros com um valor válido.

Nota: Tem de definir o período ou a data no URL do pedido.

Cabeçalhos de solicitação

Resposta

Se for bem-sucedido, este método retorna uma resposta 302 Found que redireciona para uma URL de download pré-autenticada para o relatório. Essa URL pode ser encontrada no cabeçalho Location na resposta.

Os URLs de transferência pré-autenticados só são válidos por um curto período de tempo (alguns minutos) e não requerem um Authorization cabeçalho.

O arquivo CSV possui os seguintes cabeçalhos para colunas:

• Data de atualização do relatório
• Nome da Equipe
• ID da Equipa
• Tipo de equipa
• Data da última atividade
• Período de Relatório
• Usuários ativos
• Canais Ativos
• Convidados
• Reações
• Reuniões Organizadas
• Postar Mensagens
• Mensagens de Resposta
• Mensagens de Canal
• Mensagens Urgentes
• Menções
• Canais Partilhados Ativos
• Utilizadores Externos Ativos

Exemplos

Eis um exemplo que produz CSV.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/v1.0/reports/getTeamsTeamActivityDetail(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.GetTeamsTeamActivityDetailWithPeriod("{period}").GetAsync();

// 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().GetTeamsTeamActivityDetailWithPeriod(&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().getTeamsTeamActivityDetailWithPeriod("{period}").get();

const options = {
	authProvider,
};

const client = Client.init(options);

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

<?php
use Microsoft\Graph\GraphServiceClient;


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


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

# 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_teams_team_activity_detail_with_period("{period}").get()

Resposta

O exemplo a seguir mostra a resposta.

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

Siga o redirecionamento 302 e o ficheiro CSV que as transferências têm o seguinte esquema.

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

Report Refresh Date,Team Name,Team Id,Team Type,Last Activity Date,Report Period,Active Users,Active Channels,Guests,Reactions,Meetings Organized,Post Messages,Reply Messages,Channel Messages,Urgent Messages,Mentions,Active Shared Channels,Active External Users