创建 contentActivity

2025-05-27

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

为已登录用户创建内容活动。

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

权限

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

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

HTTP 请求

POST /me/dataSecurityAndGovernance/activities/contentActivities

请求标头

名称	说明
Authorization	持有者 {token}。必填。详细了解身份验证和授权。
Content-Type	application/json. 必需。

请求正文

在请求正文中，提供 contentActivity 对象的 JSON 表示形式。

响应

如果成功，此方法在响应正文中返回响应 201 Created 代码和 contentActivity 对象。

示例

请求

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

POST https://graph.microsoft.com/beta/me/dataSecurityAndGovernance/activities/contentActivities
Content-Type: application/json

{
    "contentMetadata": {
       "contentEntries": [
          {
             "@odata.type": "microsoft.graph.processConversationMetadata",
             "identifier": "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8",
             "name":"CA Purview API Explorer message",
             "correlationId": "edfb7f88-b963-4ef2-8b30-5cb90f80e01e",
             "sequenceNumber": 0, 
             "isTruncated": false,
             "createdDateTime": "2025-05-28T20:20:37",
             "modifiedDateTime": "2025-05-28T20:20:37"
          }
       ],
       "activityMetadata": { 
          "activity": "downloadText"
       },
       "deviceMetadata": {
          "operatingSystemSpecifications": {
             "operatingSystemPlatform": "Windows 11",
             "operatingSystemVersion": "10.0.26100.0" 
          }
       },
       "integratedAppMetadata": {
          "name": "CA Purview API Explorer",
          "version": "0.1" 
       },
       "userId":"7c497f10-cba8-4a8d-9449-db4b76d1ef80",
       "scopeIdentifier":"0"
    }
}


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

// Dependencies
using Microsoft.Graph.Beta.Models;
using Microsoft.Kiota.Abstractions.Serialization;

var requestBody = new ContentActivity
{
	ContentMetadata = new ProcessContentRequest
	{
		ContentEntries = new List<ProcessContentMetadataBase>
		{
			new ProcessConversationMetadata
			{
				OdataType = "microsoft.graph.processConversationMetadata",
				Identifier = "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8",
				Name = "CA Purview API Explorer message",
				CorrelationId = "edfb7f88-b963-4ef2-8b30-5cb90f80e01e",
				SequenceNumber = 0L,
				IsTruncated = false,
				CreatedDateTime = DateTimeOffset.Parse("2025-05-28T20:20:37"),
				ModifiedDateTime = DateTimeOffset.Parse("2025-05-28T20:20:37"),
			},
		},
		ActivityMetadata = new ActivityMetadata
		{
			Activity = UserActivityType.DownloadText,
		},
		IntegratedAppMetadata = new IntegratedApplicationMetadata
		{
			Name = "CA Purview API Explorer",
			Version = "0.1",
		},
		AdditionalData = new Dictionary<string, object>
		{
			{
				"deviceMetadata" , new UntypedObject(new Dictionary<string, UntypedNode>
				{
					{
						"operatingSystemSpecifications", new UntypedObject(new Dictionary<string, UntypedNode>
						{
							{
								"operatingSystemPlatform", new UntypedString("Windows 11")
							},
							{
								"operatingSystemVersion", new UntypedString("10.0.26100.0")
							},
						})
					},
				})
			},
			{
				"userId" , "7c497f10-cba8-4a8d-9449-db4b76d1ef80"
			},
			{
				"scopeIdentifier" , "0"
			},
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.DataSecurityAndGovernance.Activities.ContentActivities.PostAsync(requestBody);

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。



mgc-beta users data-security-and-governance activities content-activities create --user-id {user-id} --body '{\
    "contentMetadata": {\
       "contentEntries": [\
          {\
             "@odata.type": "microsoft.graph.processConversationMetadata",\
             "identifier": "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8",\
             "name":"CA Purview API Explorer message",\
             "correlationId": "edfb7f88-b963-4ef2-8b30-5cb90f80e01e",\
             "sequenceNumber": 0, \
             "isTruncated": false,\
             "createdDateTime": "2025-05-28T20:20:37",\
             "modifiedDateTime": "2025-05-28T20:20:37"\
          }\
       ],\
       "activityMetadata": { \
          "activity": "downloadText"\
       },\
       "deviceMetadata": {\
          "operatingSystemSpecifications": {\
             "operatingSystemPlatform": "Windows 11",\
             "operatingSystemVersion": "10.0.26100.0" \
          }\
       },\
       "integratedAppMetadata": {\
          "name": "CA Purview API Explorer",\
          "version": "0.1" \
       },\
       "userId":"7c497f10-cba8-4a8d-9449-db4b76d1ef80",\
       "scopeIdentifier":"0"\
    }\
}\
'

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。



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

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

requestBody := graphmodels.NewContentActivity()
contentMetadata := graphmodels.NewProcessContentRequest()


processContentMetadataBase := graphmodels.NewProcessConversationMetadata()
identifier := "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8"
processContentMetadataBase.SetIdentifier(&identifier) 
name := "CA Purview API Explorer message"
processContentMetadataBase.SetName(&name) 
correlationId := "edfb7f88-b963-4ef2-8b30-5cb90f80e01e"
processContentMetadataBase.SetCorrelationId(&correlationId) 
sequenceNumber := int64(0)
processContentMetadataBase.SetSequenceNumber(&sequenceNumber) 
isTruncated := false
processContentMetadataBase.SetIsTruncated(&isTruncated) 
createdDateTime , err := time.Parse(time.RFC3339, "2025-05-28T20:20:37")
processContentMetadataBase.SetCreatedDateTime(&createdDateTime) 
modifiedDateTime , err := time.Parse(time.RFC3339, "2025-05-28T20:20:37")
processContentMetadataBase.SetModifiedDateTime(&modifiedDateTime) 

contentEntries := []graphmodels.ProcessContentMetadataBaseable {
	processContentMetadataBase,
}
contentMetadata.SetContentEntries(contentEntries)
activityMetadata := graphmodels.NewActivityMetadata()
activity := graphmodels.DOWNLOADTEXT_USERACTIVITYTYPE 
activityMetadata.SetActivity(&activity) 
contentMetadata.SetActivityMetadata(activityMetadata)
integratedAppMetadata := graphmodels.NewIntegratedApplicationMetadata()
name := "CA Purview API Explorer"
integratedAppMetadata.SetName(&name) 
version := "0.1"
integratedAppMetadata.SetVersion(&version) 
contentMetadata.SetIntegratedAppMetadata(integratedAppMetadata)
additionalData := map[string]interface{}{
deviceMetadata := graph.New()
operatingSystemSpecifications := graph.New()
operatingSystemPlatform := "Windows 11"
operatingSystemSpecifications.SetOperatingSystemPlatform(&operatingSystemPlatform) 
operatingSystemVersion := "10.0.26100.0"
operatingSystemSpecifications.SetOperatingSystemVersion(&operatingSystemVersion) 
	deviceMetadata.SetOperatingSystemSpecifications(operatingSystemSpecifications)
	contentMetadata.SetDeviceMetadata(deviceMetadata)
	"userId" : "7c497f10-cba8-4a8d-9449-db4b76d1ef80", 
	"scopeIdentifier" : "0", 
}
contentMetadata.SetAdditionalData(additionalData)
requestBody.SetContentMetadata(contentMetadata)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
contentActivities, err := graphClient.Me().DataSecurityAndGovernance().Activities().ContentActivities().Post(context.Background(), requestBody, nil)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ContentActivity contentActivity = new ContentActivity();
ProcessContentRequest contentMetadata = new ProcessContentRequest();
LinkedList<ProcessContentMetadataBase> contentEntries = new LinkedList<ProcessContentMetadataBase>();
ProcessConversationMetadata processContentMetadataBase = new ProcessConversationMetadata();
processContentMetadataBase.setOdataType("microsoft.graph.processConversationMetadata");
processContentMetadataBase.setIdentifier("d6ab5054-e111-45c3-9fba-9f2a59c9bbf8");
processContentMetadataBase.setName("CA Purview API Explorer message");
processContentMetadataBase.setCorrelationId("edfb7f88-b963-4ef2-8b30-5cb90f80e01e");
processContentMetadataBase.setSequenceNumber(0L);
processContentMetadataBase.setIsTruncated(false);
OffsetDateTime createdDateTime = OffsetDateTime.parse("2025-05-28T20:20:37");
processContentMetadataBase.setCreatedDateTime(createdDateTime);
OffsetDateTime modifiedDateTime = OffsetDateTime.parse("2025-05-28T20:20:37");
processContentMetadataBase.setModifiedDateTime(modifiedDateTime);
contentEntries.add(processContentMetadataBase);
contentMetadata.setContentEntries(contentEntries);
ActivityMetadata activityMetadata = new ActivityMetadata();
activityMetadata.setActivity(UserActivityType.DownloadText);
contentMetadata.setActivityMetadata(activityMetadata);
IntegratedApplicationMetadata integratedAppMetadata = new IntegratedApplicationMetadata();
integratedAppMetadata.setName("CA Purview API Explorer");
integratedAppMetadata.setVersion("0.1");
contentMetadata.setIntegratedAppMetadata(integratedAppMetadata);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
 deviceMetadata = new ();
 operatingSystemSpecifications = new ();
operatingSystemSpecifications.setOperatingSystemPlatform("Windows 11");
operatingSystemSpecifications.setOperatingSystemVersion("10.0.26100.0");
deviceMetadata.setOperatingSystemSpecifications(operatingSystemSpecifications);
additionalData.put("deviceMetadata", deviceMetadata);
additionalData.put("userId", "7c497f10-cba8-4a8d-9449-db4b76d1ef80");
additionalData.put("scopeIdentifier", "0");
contentMetadata.setAdditionalData(additionalData);
contentActivity.setContentMetadata(contentMetadata);
ContentActivity result = graphClient.me().dataSecurityAndGovernance().activities().contentActivities().post(contentActivity);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


const options = {
	authProvider,
};

const client = Client.init(options);

const contentActivity = {
    contentMetadata: {
       contentEntries: [
          {
             '@odata.type': 'microsoft.graph.processConversationMetadata',
             identifier: 'd6ab5054-e111-45c3-9fba-9f2a59c9bbf8',
             name: 'CA Purview API Explorer message',
             correlationId: 'edfb7f88-b963-4ef2-8b30-5cb90f80e01e',
             sequenceNumber: 0, 
             isTruncated: false,
             createdDateTime: '2025-05-28T20:20:37',
             modifiedDateTime: '2025-05-28T20:20:37'
          }
       ],
       activityMetadata: { 
          activity: 'downloadText'
       },
       deviceMetadata: {
          operatingSystemSpecifications: {
             operatingSystemPlatform: 'Windows 11',
             operatingSystemVersion: '10.0.26100.0' 
          }
       },
       integratedAppMetadata: {
          name: 'CA Purview API Explorer',
          version: '0.1' 
       },
       userId: '7c497f10-cba8-4a8d-9449-db4b76d1ef80',
       scopeIdentifier: '0'
    }
};

await client.api('/me/dataSecurityAndGovernance/activities/contentActivities')
	.version('beta')
	.post(contentActivity);

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\ContentActivity;
use Microsoft\Graph\Beta\Generated\Models\ProcessContentRequest;
use Microsoft\Graph\Beta\Generated\Models\ProcessContentMetadataBase;
use Microsoft\Graph\Beta\Generated\Models\ProcessConversationMetadata;
use Microsoft\Graph\Beta\Generated\Models\ActivityMetadata;
use Microsoft\Graph\Beta\Generated\Models\UserActivityType;
use Microsoft\Graph\Beta\Generated\Models\IntegratedApplicationMetadata;


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

$requestBody = new ContentActivity();
$contentMetadata = new ProcessContentRequest();
$contentEntriesProcessContentMetadataBase1 = new ProcessConversationMetadata();
$contentEntriesProcessContentMetadataBase1->setOdataType('microsoft.graph.processConversationMetadata');
$contentEntriesProcessContentMetadataBase1->setIdentifier('d6ab5054-e111-45c3-9fba-9f2a59c9bbf8');
$contentEntriesProcessContentMetadataBase1->setName('CA Purview API Explorer message');
$contentEntriesProcessContentMetadataBase1->setCorrelationId('edfb7f88-b963-4ef2-8b30-5cb90f80e01e');
$contentEntriesProcessContentMetadataBase1->setSequenceNumber(0);
$contentEntriesProcessContentMetadataBase1->setIsTruncated(false);
$contentEntriesProcessContentMetadataBase1->setCreatedDateTime(new \DateTime('2025-05-28T20:20:37'));
$contentEntriesProcessContentMetadataBase1->setModifiedDateTime(new \DateTime('2025-05-28T20:20:37'));
$contentEntriesArray []= $contentEntriesProcessContentMetadataBase1;
$contentMetadata->setContentEntries($contentEntriesArray);

$contentMetadataActivityMetadata = new ActivityMetadata();
$contentMetadataActivityMetadata->setActivity(new UserActivityType('downloadText'));
$contentMetadata->setActivityMetadata($contentMetadataActivityMetadata);
$contentMetadataIntegratedAppMetadata = new IntegratedApplicationMetadata();
$contentMetadataIntegratedAppMetadata->setName('CA Purview API Explorer');
$contentMetadataIntegratedAppMetadata->setVersion('0.1');
$contentMetadata->setIntegratedAppMetadata($contentMetadataIntegratedAppMetadata);
$additionalData = [
'deviceMetadata' => [
	'operatingSystemSpecifications' => [
		'operatingSystemPlatform' => 'Windows 11',
		'operatingSystemVersion' => '10.0.26100.0',
	],
],
'userId' => '7c497f10-cba8-4a8d-9449-db4b76d1ef80',
'scopeIdentifier' => '0',
];
$contentMetadata->setAdditionalData($additionalData);
$requestBody->setContentMetadata($contentMetadata);

$result = $graphServiceClient->me()->dataSecurityAndGovernance()->activities()->contentActivities()->post($requestBody)->wait();

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.content_activity import ContentActivity
from msgraph_beta.generated.models.process_content_request import ProcessContentRequest
from msgraph_beta.generated.models.process_content_metadata_base import ProcessContentMetadataBase
from msgraph_beta.generated.models.process_conversation_metadata import ProcessConversationMetadata
from msgraph_beta.generated.models.activity_metadata import ActivityMetadata
from msgraph_beta.generated.models.user_activity_type import UserActivityType
from msgraph_beta.generated.models.integrated_application_metadata import IntegratedApplicationMetadata
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ContentActivity(
	content_metadata = ProcessContentRequest(
		content_entries = [
			ProcessConversationMetadata(
				odata_type = "microsoft.graph.processConversationMetadata",
				identifier = "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8",
				name = "CA Purview API Explorer message",
				correlation_id = "edfb7f88-b963-4ef2-8b30-5cb90f80e01e",
				sequence_number = 0,
				is_truncated = False,
				created_date_time = "2025-05-28T20:20:37",
				modified_date_time = "2025-05-28T20:20:37",
			),
		],
		activity_metadata = ActivityMetadata(
			activity = UserActivityType.DownloadText,
		),
		integrated_app_metadata = IntegratedApplicationMetadata(
			name = "CA Purview API Explorer",
			version = "0.1",
		),
		additional_data = {
				"device_metadata" : {
						"operating_system_specifications" : {
								"operating_system_platform" : "Windows 11",
								"operating_system_version" : "10.0.26100.0",
						},
				},
				"user_id" : "7c497f10-cba8-4a8d-9449-db4b76d1ef80",
				"scope_identifier" : "0",
		}
	),
)

result = await graph_client.me.data_security_and_governance.activities.content_activities.post(request_body)

重要

有关如何将 SDK 添加到项目并创建 authProvider 实例的详细信息，请参阅 SDK 文档。

响应

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

注意：为了提高可读性，可能缩短了此处显示的响应对象。

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('7c497f10-cba8-4a8d-9449-db4b76d1ef80')/dataSecurityAndGovernance/activities/contentActivities/$entity",
  "id": "4c3d1219-b1af-442f-85b5-06b7ef1cf8c8",
  "userId": "7c497f10-cba8-4a8d-9449-db4b76d1ef80",
  "scopeIdentifier": null,
  "contentMetadata": {
    "protectedAppMetadata": null,
    "contentEntries": [
      {
        "identifier": "d6ab5054-e111-45c3-9fba-9f2a59c9bbf8",
        "content": null,
        "name": "CA Purview API Explorer message",
        "correlationId": "edfb7f88-b963-4ef2-8b30-5cb90f80e01e",
        "sequenceNumber": 0,
        "length": null,
        "isTruncated": false,
        "createdDateTime": "2025-05-28T20:20:37Z",
        "modifiedDateTime": "2025-05-28T20:20:37Z"
      }
    ],
    "activityMetadata": {
      "activity": "downloadText"
    },
    "deviceMetadata": {
      "deviceType": null,
      "operatingSystemSpecifications": {
        "operatingSystemPlatform": "Windows 11",
        "operatingSystemVersion": "10.0.26100.0"
      }
    },
    "integratedAppMetadata": {
      "name": "CA Purview API Explorer",
      "version": "0.1"
    }
  }
}

通过

创建 contentActivity

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

反馈

其他资源