reportRoot: getYammerActivityUserDetail

项目
10/31/2023

命名空间：microsoft.graph

获取用户执行的 Yammer 活动的详细信息。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	❌	❌	❌

权限

为此 API 选择标记为最低特权的权限。只有在应用需要它时，才使用更高的特权权限。有关委派权限和应用程序权限的详细信息，请参阅权限类型。要了解有关这些权限的详细信息，请参阅权限参考。

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	Reports.Read.All	不可用。
委派（个人 Microsoft 帐户）	不支持。	不支持。
应用	Reports.Read.All	不可用。

注意：对于允许应用代表用户读取服务使用情况报告的委托权限，租户管理员必须向用户分配适当的Microsoft Entra ID受限管理员角色。有关更多详细信息，请参阅授权 API 读取 Microsoft 365 使用情况报告。

HTTP 请求

GET /reports/getYammerActivityUserDetail(period='{period_value}')
GET /reports/getYammerActivityUserDetail(date={date_value})

函数参数

在请求 URL 中，提供以下任一参数的有效值。

参数	类型	说明
period	string	指定在多长时间内聚合报表。受支持的 {period_value} 值为：D7、D30、D90 和 D180。这些值采用格式 Dn，其中 n 表示在多少天内聚合报表。
date	Date	指定要查看用户在哪个日期执行的任何活动。 {date_value} 必须采用格式 YYYY-MM-DD。因为此报表的有效期仅为过去 30 天，所以 {date_value} 应为这个范围内的日期。

请求头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
If-None-Match	如果包含此请求头，且提供的 eTag 与文件中的当前标记一致，返回的是 `304 Not Modified` 响应代码。可选。

响应

如果成功，此方法返回 302 Found 响应，以重定向到报表的预先验证的下载 URL。可以在响应的 Location 头中找到此 URL。

预先验证的下载 URL 的有效时间很短（几分钟），不需要 Authorization 头。

CSV 文件包含下面的列标题。

报表刷新日期
用户主体名称
显示名称
用户状态
状态更改日期
上次活动日期
已发布数
已阅读数
已赞数
分配的产品
报表周期

示例

请求

以下示例显示了一个请求。

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



mgc reports get-yammer-activity-user-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().GetYammerActivityUserDetailWithPeriod(&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().getYammerActivityUserDetailWithPeriod("{period}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

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


<?php
use Microsoft\Graph\GraphServiceClient;


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


$graphServiceClient->reports()->getYammerActivityUserDetailWithPeriod('{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_activity_user_detail_with_period("{period}").get()

响应

以下示例显示了相应的响应。

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

执行 302 重定向，下载的 CSV 文件将采用以下架构。

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

Report Refresh Date,User Principal Name,Display Name,User State,State Change Date,Last Activity Date,Posted Count,Read Count,Liked Count,Assigned Products,Report Period

请求

如果指定了 date 参数，则报表的范围限定为在给定日期发生的活动。

GET https://graph.microsoft.com/v1.0/reports/getYammerActivityUserDetail(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.GetYammerActivityUserDetailWithDate(new Date(DateTime.Parse("{date}"))).GetAsync();



mgc reports get-yammer-activity-user-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().GetYammerActivityUserDetailWithDate(&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().getYammerActivityUserDetailWithDate(LocalDate.parse("{date}")).get();

Snippet not available


<?php
use Microsoft\Graph\GraphServiceClient;


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


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


Import-Module Microsoft.Graph.Reports

Get-MgReportYammerActivityUserDetail


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

响应

以下示例显示了相应的响应。

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

执行 302 重定向，下载的 CSV 文件将采用以下架构。

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

Report Refresh Date,User Principal Name,Display Name,User State,State Change Date,Last Activity Date,Posted Count,Read Count,Liked Count,Assigned Products,Report Period

通过

reportRoot: getYammerActivityUserDetail

权限

HTTP 请求

函数参数

请求头

响应

示例

请求

响应

请求

响应

反馈

其他资源