Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Actualice las propiedades de un objeto virtualEventTownhall .
Solo el organizador y el coorganizador pueden realizar cambios en un evento del ayuntamiento.
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 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
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) | VirtualEvent.ReadWrite | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | No admitida. | No admitida. |
Solicitud HTTP
PATCH /solutions/virtualEvents/townhalls/{id}
Encabezados de solicitud
| 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 solo los valores de las propiedades que se van a actualizar. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.
En la tabla siguiente se especifican las propiedades que se pueden actualizar.
| Propiedad | Tipo | Descripción |
|---|---|---|
| coOrganizers | communicationsUserIdentity (colección) | Información de identidad de los coorganizadores del evento virtual. |
| description | itemBody | Descripción del evento virtual. |
| displayName | Cadena | Nombre para mostrar del evento virtual. |
| endDateTime | dateTimeTimeZone | Fecha y hora en que finaliza el evento virtual. |
| invitedAttendees | colección de identidades | Las identidades de los asistentes invitados al ayuntamiento. Las identidades admitidas son: communicationsGuestIdentity y communicationsUserIdentity. |
| configuración | virtualEventSettings | Configuración de eventos virtuales. |
| startDateTime | dateTimeTimeZone | Fecha y hora en que se inicia el evento virtual. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto virtualEventTownhall actualizado en el cuerpo de la respuesta.
Ejemplos
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/v1.0/solutions/virtualEvents/townhalls/fc6e8c15-2fd7-1dd5-caa0-87056e6a12be
Content-Type: application/json
{
"startDateTime": {
"dateTime": "2024-03-31T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2024-03-31T17:00:00",
"timeZone": "Pacific Standard Time"
}
}
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
{
"@odata.type": "#microsoft.graph.virtualEventTownhall",
"id": "a57082a9-7629-4f74-8da0-8d621aab4d2d@4aa05bcc-1cac-4a83-a9ae-0db84b88f4ba",
"status": "draft",
"displayName": "The Impact of Tech on Our Lives",
"description": {
"content": "<p>Discusses how technology has changed the way we communicate, work, and interact with each other.<p>",
"contentType": "html"
},
"startDateTime": {
"dateTime": "2024-03-31T10:00:00",
"timeZone": "Pacific Standard Time"
},
"endDateTime": {
"dateTime": "2024-03-31T17:00:00",
"timeZone": "Pacific Standard Time"
},
"createdBy": {
"application": null,
"device": null,
"user": {
"@odata.type": "#microsoft.graph.communicationsUserIdentity",
"id": "b7ef013a-c73c-4ec7-8ccb-e56290f45f68",
"displayName": "Diane Demoss",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
},
"audience": "organization",
"isInviteOnly": false,
"coOrganizers": [
{
"id": "7b7e1acd-a3e0-4533-8c1d-c1a4ca0b2e2b",
"displayName": "Kenneth Brown",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"invitedAttendees": [
{
"@odata.type": "microsoft.graph.communicationsUserIdentity",
"id": "127962bb-84e1-7b62-fd98-1c9d39def7b6",
"displayName": "Emilee Pham",
"tenantId": "77229959-e479-4a73-b6e0-ddac27be315c"
}
],
"settings": {
"isAttendeeEmailNotificationEnabled": false
},
"externalEventInformation": [
{
"applicationId" : "1b7ba4d1-c377-4b2f-ad0e-a3fc50bc987b",
"externalEventId": "myExternalEventId"
}
]
}