Crear o reemplazar una actividad
Espacio de nombres: microsoft.graph
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.
Cree una nueva actividad de usuario o reemplácela para la aplicación. Si desea crear una actividad de usuario y su historial relacionadoItems en una solicitud, puede usar la inserción profunda.
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | UserActivity.ReadWrite.CreatedByApp | No disponible. |
| Delegado (cuenta personal de Microsoft) | UserActivity.ReadWrite.CreatedByApp | No disponible. |
| Aplicación | No admitida. | No admitida. |
Solicitud HTTP
PUT /me/activities/{appActivityId}
Nota: El valor de appActivityId de la dirección URL debe ser seguro para la dirección URL (todos los caracteres excepto los caracteres sin reserva rfc 2396 deben convertirse en su representación hexadecimal), pero el appActivityId original no tiene que ser seguro para la dirección URL.
Encabezados de solicitud
| Nombre | Tipo | Descripción |
|---|---|---|
| Authorization | string | {token} de portador. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de un objeto de actividad .
Respuesta
Si se ejecuta correctamente, este método devuelve el 201 Created código de respuesta si se creó la actividad o 200 OK si se reemplazó la actividad.
Ejemplos
Ejemplo 1: Creación de una actividad
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PUT https://graph.microsoft.com/beta/me/activities/%2Farticle%3F12345
Content-type: application/json
{
"appActivityId": "/article?12345",
"activitySourceHost": "https://www.contoso.com",
"userTimezone": "Africa/Casablanca",
"appDisplayName": "Contoso, Ltd.",
"activationUrl": "https://www.contoso.com/article?id=12345",
"contentUrl": "https://www.contoso.com/article?id=12345",
"fallbackUrl": "https://www.contoso.com/article?id=12345",
"contentInfo": {
"@context": "https://schema.org",
"@type": "Article",
"author": "Jennifer Booth",
"name": "How to Tie a Reef Knot"
},
"visualElements": {
"attribution": {
"iconUrl": "https://www.contoso.com/icon",
"alternateText": "Contoso, Ltd.",
"addImageQuery": "false"
},
"description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
"backgroundColor": "#ff0000",
"displayText": "Contoso How-To: How to Tie a Reef Knot",
"content": {
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"body": [
{
"type": "TextBlock",
"text": "Contoso MainPage"
}
]
}
}
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"activitySourceHost": "https://contoso.com",
"createdDateTime": "2017-06-09T20:54:43.969Z",
"lastModifiedDateTime": "2017-06-09T20:54:43.969Z",
"id": "14332800362997268276",
"appActivityId": "/article?12345",
"status": "updated",
"expirationDateTime": "2017-02-26T20:20:48.114Z",
"visualElements": {
"displayText": "Contoso How-To: How to Tie a Reef Knot",
"description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
"attribution": {
"iconUrl": "https://www.contoso.com/icon",
"alternateText": "Contoso, Ltd.",
"addImageQuery": "false"
},
"backgroundColor": "#ff0000",
"content": {
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"body": [
{
"type": "TextBlock",
"text": "Contoso MainPage"
}
]
}
},
"activationUrl": "https://www.contoso.com/article?id=12345",
"appDisplayName": "Contoso, Ltd.",
"userTimezone": "Africa/Casablanca",
"fallbackUrl": "https://www.contoso.com/article?id=12345",
"contentUrl": "https://www.contoso.com/article?id=12345",
"contentInfo": {
"@context": "https://schema.org",
"@type": "Article",
"author": "Jennifer Booth",
"name": "How to Tie a Reef Knot"
}
}
Ejemplo 2: Inserción profunda
En este ejemplo se crea una nueva actividad y un elemento de historial para esa actividad en una solicitud.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PUT https://graph.microsoft.com/beta/me/activities/%2Farticle%3F12345
Content-type: application/json
{
"appActivityId": "/article?12345",
"activitySourceHost": "https://www.contoso.com",
"userTimezone": "Africa/Casablanca",
"appDisplayName": "Contoso, Ltd.",
"activationUrl": "https://www.contoso.com/article?id=12345",
"contentUrl": "https://www.contoso.com/article?id=12345",
"fallbackUrl": "https://www.contoso.com/article?id=12345",
"contentInfo": {
"@context": "https://schema.org",
"@type": "Article",
"author": "Jennifer Booth",
"name": "How to Tie a Reef Knot"
},
"visualElements": {
"attribution": {
"iconUrl": "https://www.contoso.com/icon",
"alternateText": "Contoso, Ltd.",
"addImageQuery": "false"
},
"description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
"backgroundColor": "#ff0000",
"displayText": "Contoso How-To: How to Tie a Reef Knot",
"content": {
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"body": [
{
"type": "TextBlock",
"text": "Contoso MainPage"
}
]
}
},
"historyItems": [
{
"userTimezone": "Africa/Casablanca",
"startedDateTime": "2018-02-26T20:54:04.345Z",
"lastActiveDateTime": "2018-02-26T20:54:24.345Z"
}
]
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-Type: application/json
{
"activitySourceHost": "https://contoso.com",
"createdDateTime": "2017-06-09T20:54:43.969Z",
"lastModifiedDateTime": "2017-06-09T20:54:43.969Z",
"id": "14332800362997268276",
"appActivityId": "/article?12345",
"status": "updated",
"expirationDateTime": "2017-02-26T20:20:48.114Z",
"visualElements": {
"displayText": "Contoso How-To: How to Tie a Reef Knot",
"description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
"attribution": {
"iconUrl": "https://www.contoso.com/icon",
"alternateText": "Contoso, Ltd.",
"addImageQuery": "false"
},
"backgroundColor": "#ff0000",
"content": {
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"body": [
{
"type": "TextBlock",
"text": "Contoso MainPage"
}
]
}
},
"activationUrl": "https://www.contoso.com/article?id=12345",
"appDisplayName": "Contoso, Ltd.",
"userTimezone": "Africa/Casablanca",
"fallbackUrl": "https://www.contoso.com/article?id=12345",
"contentUrl": "https://www.contoso.com/article?id=12345",
"contentInfo": {
"@context": "https://schema.org",
"@type": "Article",
"author": "Jennifer Booth",
"name": "How to Tie a Reef Knot"
},
"historyItems": [
{
"status": "updated",
"userTimezone": "Africa/Casablanca",
"createdDateTime": "2018-04-12T21:42:42.495Z",
"lastModifiedDateTime": "2018-04-12T21:42:42.495Z",
"id": "61fc8f36-919f-4b73-89d4-1cb7b159d912",
"startedDateTime": "2018-02-26T20:54:04.345Z",
"lastActiveDateTime": "2018-02-26T20:54:24.345Z",
"expirationDateTime": "2018-05-12T21:42:42.495Z",
"activeDurationSeconds": 20
}
]
}
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de