Создать contentActivity

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Создайте действие с контентом для вошедшего пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание	Правительство США L4	Правительство США L5 (DOD)	Китай, обслуживаемый 21Vianet
✅	✅	✅	❌

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшим объемом привилегий	Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись)	ContentActivity.Write	Недоступно.
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.	Не поддерживается.
Приложение	ContentActivity.Write	Недоступно.

HTTP-запрос

POST /me/dataSecurityAndGovernance/activities/contentActivities

Примечание.

Для вызова конечной точки /me требуется вход пользователя и, следовательно, делегированное разрешение. Разрешения приложений не поддерживаются при использовании /me конечной точки.

POST /users/{userId}/dataSecurityAndGovernance/activities/contentActivities

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type	application/json. Обязательно.

Текст запроса

В тексте запроса укажите JSON-представление объекта contentActivity .

Отклик

В случае успеха этот метод возвращает код отклика 201 Created и объект contentActivity в тексте ответа.

Примеры

Запрос

Ниже показан пример запроса.

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

{
    "contentToProcess": {
       "contentEntries": [
          {
             "@odata.type": "microsoft.graph.processConversationMetadata",
             "identifier": "07785517-9081-4fe7-a9dc-85bcdf5e9075",
             "name":"PC Purview API Explorer message",
             "correlationId": "d63eafd2-e3a9-4c1a-b726-a2e9b9d9580d",
             "sequenceNumber": 0, 
             "isTruncated": false,
             "createdDateTime": "2025-05-27T17:23:20",
             "modifiedDateTime": "2025-05-27T17:23:20",
             "agents": [
              {
                "identifier": "b262a092-6a2b-4682-9c7f-00baf80dbd84",
                "name": "Copilot Agent",
                "version": "1.2",
                "blueprintId": "c262a092-6a2b-4682-9c7f-00baf80dbd94"
              }
            ],
            "plugins": [
              {
                "identifier": "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
                "name": "Microsoft Purview Data Scanner",
                "version": "1.1"
              }
            ],
            "accessedResources_v2": [
              {
                "identifier": "3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123",
                "name": "Report.xlsx",
                "url": "https://contoso.sharepoint.com/sites/finance",
                "labelId": "a7b4f8c9-1e2d-4f45-89b1-23456789abcd",
                "accessType": "read",
                "status": "success",
                "isCrossPromptInjectionDetected": false
              }
            ]
          }
       ],
       "activityMetadata": { 
          "activity": "uploadText"
       },
       "deviceMetadata": {
          "operatingSystemSpecifications": {
             "operatingSystemPlatform": "Windows 11",
             "operatingSystemVersion": "10.0.26100.0" 
          },
          "ipAddress": "127.0.0.1"
       },
       "protectedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.2",
          "applicationLocation":{
             "@odata.type": "microsoft.graph.policyLocationApplication",
             "value": "83ef208a-0396-4893-9d4f-d36efbffc8bd"
          }
       },
       "integratedAppMetadata": {
          "name": "PC Purview API Explorer",
          "version": "0.2" 
       }
    }
}


// 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
{
	AdditionalData = new Dictionary<string, object>
	{
		{
			"contentToProcess" , new UntypedObject(new Dictionary<string, UntypedNode>
			{
				{
					"contentEntries", new UntypedArray(new List<UntypedNode>
					{
						new UntypedObject(new Dictionary<string, UntypedNode>
						{
							{
								"@odata.type", new UntypedString("microsoft.graph.processConversationMetadata")
							},
							{
								"identifier", new UntypedString("07785517-9081-4fe7-a9dc-85bcdf5e9075")
							},
							{
								"name", new UntypedString("PC Purview API Explorer message")
							},
							{
								"correlationId", new UntypedString("d63eafd2-e3a9-4c1a-b726-a2e9b9d9580d")
							},
							{
								"sequenceNumber", new UntypedString("0")
							},
							{
								"isTruncated", new UntypedBoolean(false)
							},
							{
								"createdDateTime", new UntypedString("2025-05-27T17:23:20")
							},
							{
								"modifiedDateTime", new UntypedString("2025-05-27T17:23:20")
							},
							{
								"agents", new UntypedArray(new List<UntypedNode>
								{
									new UntypedObject(new Dictionary<string, UntypedNode>
									{
										{
											"identifier", new UntypedString("b262a092-6a2b-4682-9c7f-00baf80dbd84")
										},
										{
											"name", new UntypedString("Copilot Agent")
										},
										{
											"version", new UntypedString("1.2")
										},
										{
											"blueprintId", new UntypedString("c262a092-6a2b-4682-9c7f-00baf80dbd94")
										},
									}),
								})
							},
							{
								"plugins", new UntypedArray(new List<UntypedNode>
								{
									new UntypedObject(new Dictionary<string, UntypedNode>
									{
										{
											"identifier", new UntypedString("f1a2b3c4-d5e6-7890-abcd-ef1234567890")
										},
										{
											"name", new UntypedString("Microsoft Purview Data Scanner")
										},
										{
											"version", new UntypedString("1.1")
										},
									}),
								})
							},
							{
								"accessedResources_v2", new UntypedArray(new List<UntypedNode>
								{
									new UntypedObject(new Dictionary<string, UntypedNode>
									{
										{
											"identifier", new UntypedString("3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123")
										},
										{
											"name", new UntypedString("Report.xlsx")
										},
										{
											"url", new UntypedString("https://contoso.sharepoint.com/sites/finance")
										},
										{
											"labelId", new UntypedString("a7b4f8c9-1e2d-4f45-89b1-23456789abcd")
										},
										{
											"accessType", new UntypedString("read")
										},
										{
											"status", new UntypedString("success")
										},
										{
											"isCrossPromptInjectionDetected", new UntypedBoolean(false)
										},
									}),
								})
							},
						}),
					})
				},
				{
					"activityMetadata", new UntypedObject(new Dictionary<string, UntypedNode>
					{
						{
							"activity", new UntypedString("uploadText")
						},
					})
				},
				{
					"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")
								},
							})
						},
						{
							"ipAddress", new UntypedString("127.0.0.1")
						},
					})
				},
				{
					"protectedAppMetadata", new UntypedObject(new Dictionary<string, UntypedNode>
					{
						{
							"name", new UntypedString("PC Purview API Explorer")
						},
						{
							"version", new UntypedString("0.2")
						},
						{
							"applicationLocation", new UntypedObject(new Dictionary<string, UntypedNode>
							{
								{
									"@odata.type", new UntypedString("microsoft.graph.policyLocationApplication")
								},
								{
									"value", new UntypedString("83ef208a-0396-4893-9d4f-d36efbffc8bd")
								},
							})
						},
					})
				},
				{
					"integratedAppMetadata", new UntypedObject(new Dictionary<string, UntypedNode>
					{
						{
							"name", new UntypedString("PC Purview API Explorer")
						},
						{
							"version", new UntypedString("0.2")
						},
					})
				},
			})
		},
	},
};

// 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);

Важно!

Пакеты SDK для Microsoft Graph по умолчанию используют версию API версии 1.0 и поддерживают не все типы, свойства и API, доступные в бета-версии. Дополнительные сведения о доступе к бета-API с помощью SDK см. в статье Использование пакетов Microsoft Graph SDK с бета-API.

Подробнее о том, как добавить 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();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
 contentToProcess = new ();
LinkedList<Object> contentEntries = new LinkedList<Object>();
 property = new ();
property.setOdataType("microsoft.graph.processConversationMetadata");
property.setIdentifier("07785517-9081-4fe7-a9dc-85bcdf5e9075");
property.setName("PC Purview API Explorer message");
property.setCorrelationId("d63eafd2-e3a9-4c1a-b726-a2e9b9d9580d");
property.setSequenceNumber(0);
property.setIsTruncated(false);
property.setCreatedDateTime("2025-05-27T17:23:20");
property.setModifiedDateTime("2025-05-27T17:23:20");
LinkedList<Object> agents = new LinkedList<Object>();
 property1 = new ();
property1.setIdentifier("b262a092-6a2b-4682-9c7f-00baf80dbd84");
property1.setName("Copilot Agent");
property1.setVersion("1.2");
property1.setBlueprintId("c262a092-6a2b-4682-9c7f-00baf80dbd94");
agents.add(property1);
property.setAgents(agents);
LinkedList<Object> plugins = new LinkedList<Object>();
 property2 = new ();
property2.setIdentifier("f1a2b3c4-d5e6-7890-abcd-ef1234567890");
property2.setName("Microsoft Purview Data Scanner");
property2.setVersion("1.1");
plugins.add(property2);
property.setPlugins(plugins);
LinkedList<Object> accessedResourcesV2 = new LinkedList<Object>();
 property3 = new ();
property3.setIdentifier("3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123");
property3.setName("Report.xlsx");
property3.setUrl("https://contoso.sharepoint.com/sites/finance");
property3.setLabelId("a7b4f8c9-1e2d-4f45-89b1-23456789abcd");
property3.setAccessType("read");
property3.setStatus("success");
property3.setIsCrossPromptInjectionDetected(false);
accessedResourcesV2.add(property3);
property.setAccessedResourcesV2(accessedResourcesV2);
contentEntries.add(property);
contentToProcess.setContentEntries(contentEntries);
 activityMetadata = new ();
activityMetadata.setActivity("uploadText");
contentToProcess.setActivityMetadata(activityMetadata);
 deviceMetadata = new ();
 operatingSystemSpecifications = new ();
operatingSystemSpecifications.setOperatingSystemPlatform("Windows 11");
operatingSystemSpecifications.setOperatingSystemVersion("10.0.26100.0");
deviceMetadata.setOperatingSystemSpecifications(operatingSystemSpecifications);
deviceMetadata.setIpAddress("127.0.0.1");
contentToProcess.setDeviceMetadata(deviceMetadata);
 protectedAppMetadata = new ();
protectedAppMetadata.setName("PC Purview API Explorer");
protectedAppMetadata.setVersion("0.2");
 applicationLocation = new ();
applicationLocation.setOdataType("microsoft.graph.policyLocationApplication");
applicationLocation.setValue("83ef208a-0396-4893-9d4f-d36efbffc8bd");
protectedAppMetadata.setApplicationLocation(applicationLocation);
contentToProcess.setProtectedAppMetadata(protectedAppMetadata);
 integratedAppMetadata = new ();
integratedAppMetadata.setName("PC Purview API Explorer");
integratedAppMetadata.setVersion("0.2");
contentToProcess.setIntegratedAppMetadata(integratedAppMetadata);
additionalData.put("contentToProcess", contentToProcess);
contentActivity.setAdditionalData(additionalData);
ContentActivity result = graphClient.me().dataSecurityAndGovernance().activities().contentActivities().post(contentActivity);

Важно!

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const contentActivity = {
    contentToProcess: {
       contentEntries: [
          {
             '@odata.type': 'microsoft.graph.processConversationMetadata',
             identifier: '07785517-9081-4fe7-a9dc-85bcdf5e9075',
             name: 'PC Purview API Explorer message',
             correlationId: 'd63eafd2-e3a9-4c1a-b726-a2e9b9d9580d',
             sequenceNumber: 0, 
             isTruncated: false,
             createdDateTime: '2025-05-27T17:23:20',
             modifiedDateTime: '2025-05-27T17:23:20',
             agents: [
              {
                identifier: 'b262a092-6a2b-4682-9c7f-00baf80dbd84',
                name: 'Copilot Agent',
                version: '1.2',
                blueprintId: 'c262a092-6a2b-4682-9c7f-00baf80dbd94'
              }
            ],
            plugins: [
              {
                identifier: 'f1a2b3c4-d5e6-7890-abcd-ef1234567890',
                name: 'Microsoft Purview Data Scanner',
                version: '1.1'
              }
            ],
            accessedResources_v2: [
              {
                identifier: '3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123',
                name: 'Report.xlsx',
                url: 'https://contoso.sharepoint.com/sites/finance',
                labelId: 'a7b4f8c9-1e2d-4f45-89b1-23456789abcd',
                accessType: 'read',
                status: 'success',
                isCrossPromptInjectionDetected: false
              }
            ]
          }
       ],
       activityMetadata: { 
          activity: 'uploadText'
       },
       deviceMetadata: {
          operatingSystemSpecifications: {
             operatingSystemPlatform: 'Windows 11',
             operatingSystemVersion: '10.0.26100.0' 
          },
          ipAddress: '127.0.0.1'
       },
       protectedAppMetadata: {
          name: 'PC Purview API Explorer',
          version: '0.2',
          applicationLocation: {
             '@odata.type': 'microsoft.graph.policyLocationApplication',
             value: '83ef208a-0396-4893-9d4f-d36efbffc8bd'
          }
       },
       integratedAppMetadata: {
          name: 'PC Purview API Explorer',
          version: '0.2' 
       }
    }
};

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;


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

$requestBody = new ContentActivity();
$additionalData = [
	'contentToProcess' => [
		'contentEntries' => [
				[
					'@odata.type' => 'microsoft.graph.processConversationMetadata',
					'identifier' => '07785517-9081-4fe7-a9dc-85bcdf5e9075',
					'name' => 'PC Purview API Explorer message',
					'correlationId' => 'd63eafd2-e3a9-4c1a-b726-a2e9b9d9580d',
					'sequenceNumber' => 0,
					'isTruncated' => false,
					'createdDateTime' => '2025-05-27T17:23:20',
					'modifiedDateTime' => '2025-05-27T17:23:20',
					'agents' => [
							[
								'identifier' => 'b262a092-6a2b-4682-9c7f-00baf80dbd84',
								'name' => 'Copilot Agent',
								'version' => '1.2',
								'blueprintId' => 'c262a092-6a2b-4682-9c7f-00baf80dbd94',
							],
						],
					'plugins' => [
							[
								'identifier' => 'f1a2b3c4-d5e6-7890-abcd-ef1234567890',
								'name' => 'Microsoft Purview Data Scanner',
								'version' => '1.1',
							],
						],
					'accessedResources_v2' => [
							[
								'identifier' => '3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123',
								'name' => 'Report.xlsx',
								'url' => 'https://contoso.sharepoint.com/sites/finance',
								'labelId' => 'a7b4f8c9-1e2d-4f45-89b1-23456789abcd',
								'accessType' => 'read',
								'status' => 'success',
								'isCrossPromptInjectionDetected' => false,
							],
						],
				],
			],
		'activityMetadata' => [
			'activity' => 'uploadText',
		],
		'deviceMetadata' => [
			'operatingSystemSpecifications' => [
				'operatingSystemPlatform' => 'Windows 11',
				'operatingSystemVersion' => '10.0.26100.0',
			],
			'ipAddress' => '127.0.0.1',
		],
		'protectedAppMetadata' => [
			'name' => 'PC Purview API Explorer',
			'version' => '0.2',
			'applicationLocation' => [
				'@odata.type' => 'microsoft.graph.policyLocationApplication',
				'value' => '83ef208a-0396-4893-9d4f-d36efbffc8bd',
			],
		],
		'integratedAppMetadata' => [
			'name' => 'PC Purview API Explorer',
			'version' => '0.2',
		],
	],
];
$requestBody->setAdditionalData($additionalData);

$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
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ContentActivity(
	additional_data = {
			"content_to_process" : {
					"content_entries" : [
						{
								"@odata_type" : "microsoft.graph.processConversationMetadata",
								"identifier" : "07785517-9081-4fe7-a9dc-85bcdf5e9075",
								"name" : "PC Purview API Explorer message",
								"correlation_id" : "d63eafd2-e3a9-4c1a-b726-a2e9b9d9580d",
								"sequence_number" : 0,
								"is_truncated" : False,
								"created_date_time" : "2025-05-27T17:23:20",
								"modified_date_time" : "2025-05-27T17:23:20",
								"agents" : [
									{
											"identifier" : "b262a092-6a2b-4682-9c7f-00baf80dbd84",
											"name" : "Copilot Agent",
											"version" : "1.2",
											"blueprint_id" : "c262a092-6a2b-4682-9c7f-00baf80dbd94",
									},
								],
								"plugins" : [
									{
											"identifier" : "f1a2b3c4-d5e6-7890-abcd-ef1234567890",
											"name" : "Microsoft Purview Data Scanner",
											"version" : "1.1",
									},
								],
								"accessed_resources_v2" : [
									{
											"identifier" : "3f2d6e5b-98d4-4f2a-9a61-45c0a8b7d123",
											"name" : "Report.xlsx",
											"url" : "https://contoso.sharepoint.com/sites/finance",
											"label_id" : "a7b4f8c9-1e2d-4f45-89b1-23456789abcd",
											"access_type" : "read",
											"status" : "success",
											"is_cross_prompt_injection_detected" : False,
									},
								],
						},
					],
					"activity_metadata" : {
							"activity" : "uploadText",
					},
					"device_metadata" : {
							"operating_system_specifications" : {
									"operating_system_platform" : "Windows 11",
									"operating_system_version" : "10.0.26100.0",
							},
							"ip_address" : "127.0.0.1",
					},
					"protected_app_metadata" : {
							"name" : "PC Purview API Explorer",
							"version" : "0.2",
							"application_location" : {
									"@odata_type" : "microsoft.graph.policyLocationApplication",
									"value" : "83ef208a-0396-4893-9d4f-d36efbffc8bd",
							},
					},
					"integrated_app_metadata" : {
							"name" : "PC Purview API Explorer",
							"version" : "0.2",
					},
			},
	}
)

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"
    }
  }
}

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-08-18

Создать contentActivity

Разрешения

HTTP-запрос

Заголовки запросов

Текст запроса

Отклик

Примеры

Запрос

Отклик

Обратная связь

Дополнительные ресурсы