Espacio de nombres: microsoft.graph.externalConnectors
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Anexar instancias adicionales de objetos externalActivity en un externalItem.
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 |
| ✅ |
✅ |
✅ |
❌ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso |
Permisos (de menos a más privilegiados) |
| Delegado (cuenta profesional o educativa) |
No admitida. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
| Aplicación |
ExternalItem.ReadWrite.OwnedBy, ExternalItem.ReadWrite.All |
Solicitud HTTP
POST external/connections/{connectionsId}/items/{externalItemId}/addActivities
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
La siguiente tabla muestra los parámetros que se pueden usar con esta acción.
Respuesta
Si se ejecuta correctamente, esta acción devuelve un 200 OK código de respuesta y una colección de objetos microsoft.graph.externalConnectors.externalActivityResult en el cuerpo de la respuesta.
Un 207 Multi-Status código de respuesta indica que solo algunas de las instancias de externalActivity agregadas se procesaron correctamente. El autor de la llamada debe inspeccionar la carga de respuesta y examinar el campo de error de cada externalActivityResult para determinar por qué no se procesó la instancia de externalActivity y qué acción se puede realizar. Una null propiedad de error indica que externalActivityResult se realizó correctamente.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/beta/external/connections/contosohr/items/TSP228082938/addActivities
Content-Type: application/json
Content-length: 190
{
"activities": [
{
"@odata.type": "#microsoft.graph.externalConnectors.externalActivity",
"type": "created",
"startDateTime": "2021-04-06T18:04:31.033Z",
"performedBy": {
"type": "user",
"id": "1f0c997e-99f7-43f1-8cca-086f8d42be8d"
}
}
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.External.Connections.Item.Items.Item.MicrosoftGraphExternalConnectorsAddActivities;
using Microsoft.Graph.Beta.Models.ExternalConnectors;
var requestBody = new AddActivitiesPostRequestBody
{
Activities = new List<ExternalActivity>
{
new ExternalActivity
{
OdataType = "#microsoft.graph.externalConnectors.externalActivity",
Type = ExternalActivityType.Created,
StartDateTime = DateTimeOffset.Parse("2021-04-06T18:04:31.033Z"),
PerformedBy = new Identity
{
Type = IdentityType.User,
Id = "1f0c997e-99f7-43f1-8cca-086f8d42be8d",
},
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.External.Connections["{externalConnection-id}"].Items["{externalItem-id}"].MicrosoftGraphExternalConnectorsAddActivities.PostAsAddActivitiesPostResponseAsync(requestBody);
// 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"
graphexternal "github.com/microsoftgraph/msgraph-beta-sdk-go/external"
graphmodelsexternalconnectors "github.com/microsoftgraph/msgraph-beta-sdk-go/models/externalconnectors"
//other-imports
)
requestBody := graphexternal.NewAddActivitiesPostRequestBody()
externalActivity := graphmodelsexternalconnectors.NewExternalActivity()
type := graphmodels.CREATED_EXTERNALACTIVITYTYPE
externalActivity.SetType(&type)
startDateTime , err := time.Parse(time.RFC3339, "2021-04-06T18:04:31.033Z")
externalActivity.SetStartDateTime(&startDateTime)
performedBy := graphmodelsexternalconnectors.NewIdentity()
type := graphmodels.USER_IDENTITYTYPE
performedBy.SetType(&type)
id := "1f0c997e-99f7-43f1-8cca-086f8d42be8d"
performedBy.SetId(&id)
externalActivity.SetPerformedBy(performedBy)
activities := []graphmodelsexternalconnectors.ExternalActivityable {
externalActivity,
}
requestBody.SetActivities(activities)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
microsoftGraphExternalConnectorsAddActivities, err := graphClient.External().Connections().ByExternalConnectionId("externalConnection-id").Items().ByExternalItemId("externalItem-id").MicrosoftGraphExternalConnectorsAddActivities().PostAsAddActivitiesPostResponse(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.external.connections.item.items.item.microsoftgraphexternalconnectorsaddactivities.AddActivitiesPostRequestBody addActivitiesPostRequestBody = new com.microsoft.graph.beta.external.connections.item.items.item.microsoftgraphexternalconnectorsaddactivities.AddActivitiesPostRequestBody();
LinkedList<com.microsoft.graph.beta.models.externalconnectors.ExternalActivity> activities = new LinkedList<com.microsoft.graph.beta.models.externalconnectors.ExternalActivity>();
com.microsoft.graph.beta.models.externalconnectors.ExternalActivity externalActivity = new com.microsoft.graph.beta.models.externalconnectors.ExternalActivity();
externalActivity.setOdataType("#microsoft.graph.externalConnectors.externalActivity");
externalActivity.setType(com.microsoft.graph.beta.models.externalconnectors.ExternalActivityType.Created);
OffsetDateTime startDateTime = OffsetDateTime.parse("2021-04-06T18:04:31.033Z");
externalActivity.setStartDateTime(startDateTime);
com.microsoft.graph.beta.models.externalconnectors.Identity performedBy = new com.microsoft.graph.beta.models.externalconnectors.Identity();
performedBy.setType(com.microsoft.graph.beta.models.externalconnectors.IdentityType.User);
performedBy.setId("1f0c997e-99f7-43f1-8cca-086f8d42be8d");
externalActivity.setPerformedBy(performedBy);
activities.add(externalActivity);
addActivitiesPostRequestBody.setActivities(activities);
var result = graphClient.external().connections().byExternalConnectionId("{externalConnection-id}").items().byExternalItemId("{externalItem-id}").microsoftGraphExternalConnectorsAddActivities().post(addActivitiesPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const externalActivityResult = {
activities: [
{
'@odata.type': '#microsoft.graph.externalConnectors.externalActivity',
type: 'created',
startDateTime: '2021-04-06T18:04:31.033Z',
performedBy: {
type: 'user',
id: '1f0c997e-99f7-43f1-8cca-086f8d42be8d'
}
}
]
};
await client.api('/external/connections/contosohr/items/TSP228082938/addActivities')
.version('beta')
.post(externalActivityResult);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\External\Connections\Item\Items\Item\MicrosoftGraphExternalConnectorsAddActivities\AddActivitiesPostRequestBody;
use Microsoft\Graph\Beta\Generated\Models\ExternalConnectors\ExternalActivity;
use Microsoft\Graph\Beta\Generated\Models\ExternalConnectors\ExternalActivityType;
use Microsoft\Graph\Beta\Generated\Models\ExternalConnectors\Identity;
use Microsoft\Graph\Beta\Generated\Models\ExternalConnectors\IdentityType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new AddActivitiesPostRequestBody();
$activitiesExternalActivity1 = new ExternalActivity();
$activitiesExternalActivity1->setOdataType('#microsoft.graph.externalConnectors.externalActivity');
$activitiesExternalActivity1->setType(new ExternalActivityType('created'));
$activitiesExternalActivity1->setStartDateTime(new \DateTime('2021-04-06T18:04:31.033Z'));
$activitiesExternalActivity1PerformedBy = new Identity();
$activitiesExternalActivity1PerformedBy->setType(new IdentityType('user'));
$activitiesExternalActivity1PerformedBy->setId('1f0c997e-99f7-43f1-8cca-086f8d42be8d');
$activitiesExternalActivity1->setPerformedBy($activitiesExternalActivity1PerformedBy);
$activitiesArray []= $activitiesExternalActivity1;
$requestBody->setActivities($activitiesArray);
$result = $graphServiceClient->external()->connections()->byExternalConnectionId('externalConnection-id')->items()->byExternalItemId('externalItem-id')->microsoftGraphExternalConnectorsAddActivities()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Search
$params = @{
activities = @(
@{
"@odata.type" = "#microsoft.graph.externalConnectors.externalActivity"
type = "created"
startDateTime = [System.DateTime]::Parse("2021-04-06T18:04:31.033Z")
performedBy = @{
type = "user"
id = "1f0c997e-99f7-43f1-8cca-086f8d42be8d"
}
}
)
}
Add-MgBetaExternalConnectionItemActivity -ExternalConnectionId $externalConnectionId -ExternalItemId $externalItemId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.external.connections.item.items.item.microsoft_graph_external_connectors_add_activities.add_activities_post_request_body import AddActivitiesPostRequestBody
from msgraph_beta.generated.models.external_connectors.external_activity import ExternalActivity
from msgraph_beta.generated.models.external_activity_type import ExternalActivityType
from msgraph_beta.generated.models.external_connectors.identity import Identity
from msgraph_beta.generated.models.identity_type import IdentityType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = AddActivitiesPostRequestBody(
activities = [
ExternalActivity(
odata_type = "#microsoft.graph.externalConnectors.externalActivity",
type = ExternalActivityType.Created,
start_date_time = "2021-04-06T18:04:31.033Z",
performed_by = Identity(
type = IdentityType.User,
id = "1f0c997e-99f7-43f1-8cca-086f8d42be8d",
),
),
],
)
result = await graph_client.external.connections.by_external_connection_id('externalConnection-id').items.by_external_item_id('externalItem-id').microsoft_graph_external_connectors_add_activities.post(request_body)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.externalConnectors.externalActivityResult",
"type": "created",
"startDateTime": "2021-04-06T18:04:31.033Z",
"error": null
}
]
}