Actualizar onlineMeeting

  • Artículo

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.

Actualice las propiedades del objeto onlineMeeting especificado.

Consulte la sección Cuerpo de la solicitud para obtener la lista de propiedades que admiten la actualización.

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) OnlineMeetings.ReadWrite No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Para usar el permiso de aplicación para esta API, los administradores de inquilinos deben crear una directiva de acceso a la aplicación y concederla a un usuario para autorizar a la aplicación configurada en la directiva para actualizar las reuniones en línea en nombre de ese usuario (con el identificador de usuario especificado en la ruta de acceso de solicitud).

Solicitud HTTP

Para actualizar el onlineMeeting especificado mediante el identificador de reunión con el permiso delegado (/me) y de aplicación (/users/{userId}/):

PATCH /me/onlineMeetings/{meetingId}
PATCH /users/{userId}/onlineMeetings/{meetingId}

Nota:

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Tipo de contenido application/json. Obligatorio.

Cuerpo de la solicitud

En la tabla siguiente se enumeran las propiedades que se pueden actualizar. En el cuerpo de la solicitud, incluya solo las propiedades que necesiten actualizarse, con las siguientes excepciones:

  • Actualizar la fecha y hora de inicio o finalización de una reunión en línea siempre requiere las propiedades startDateTime y endDateTime en el cuerpo de la solicitud.
  • No se puede actualizar el campo organizador de la propiedad participants . El organizador de la reunión no se puede modificar después de crear la reunión.
  • Actualizar el campo asistentes de la propiedad participants , como agregar o quitar un asistente a la reunión, siempre requiere la lista completa de asistentes en el cuerpo de la solicitud.

La última columna indica si la actualización de esta propiedad surtirá efecto para una reunión en curso.

Propiedad Tipo Descripción ¿Se aplica a las reuniones en curso?
startDateTime DateTime Hora de inicio de la reunión en UTC. No
endDateTime DateTime Hora de finalización de la reunión en UTC. No
subject Cadena Tema de la reunión en línea. No
participants meetingParticipants Los participantes asociados a la reunión en línea. Solo se pueden actualizar los asistentes. No
isEntryExitAnnounced Booleano Si se anuncia o no cuando los autores de llamadas se unen o se van. Sí
lobbyBypassSettings lobbyBypassSettings Especifica qué participantes pueden omitir la sala de reuniones. Sí
allowedPresenters onlineMeetingPresenters Especifica quién puede ser moderador en una reunión. Sí
allowAttendeeToEnableCamera Booleano Indica si los asistentes pueden activar su cámara. Sí
allowAttendeeToEnableMic Booleano Indica si los asistentes pueden activar su micrófono. Sí
allowMeetingChat meetingChatMode Especifica el modo de chat de reunión. Sí
allowTeamworkReactions Booleano Indica si las reacciones de Teams están habilitadas para la reunión. Sí
recordAutomatically Booleano Indica si se va a grabar la reunión automáticamente. No

Nota:

  • Para obtener la lista de valores posibles para allowedPresenters y allowMeetingChat, consulte onlineMeeting.
  • Al actualizar el valor de allowedPresenters a roleIsPresenter, incluya una lista completa de asistentes con el rol de asistentes especificado establecido presenter en en el cuerpo de la solicitud.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto onlineMeeting actualizado en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Actualizar startDateTime, endDateTime y subject

Solicitud

Nota: El identificador de reunión se ha acortado para mejorar la legibilidad.

PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "startDateTime": "2020-09-09T14:33:30.8546353-07:00",
  "endDateTime": "2020-09-09T15:03:30.8566356-07:00",
  "subject": "Patch Meeting Subject"
}

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

{
   "id":"MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
   "creationDateTime":"2020-07-03T00:23:39.444642Z",
   "startDateTime":"2020-09-09T21:33:30.8546353Z",
   "endDateTime":"2020-09-09T22:03:30.8566356Z",
   "joinWebUrl":"url",
   "subject":"Patch Meeting Subject",
   "isBroadcast":false,
   "autoAdmittedUsers":"EveryoneInCompany",
   "outerMeetingAutoAdmittedUsers":null,
   "participants":{
      "organizer":{
         "upn":"upn",
         "role": "presenter",
         "identity":{
            "azureApplicationInstance":null,
            "applicationInstance":null,
            "application":null,
            "device":null,
            "user":{
               "id":"8716745d-77a9-4be3-afff-009e4b81658e",
               "displayName":null,
               "tenantId":"0823831b-1f1b-424b-b90a-1caa345a742a",
               "identityProvider":"AAD"
            }
         }
      }
   },
   "audioConferencing":{
      "conferenceId":"id",
      "tollNumber":"+1-900-555-0100",
      "tollFreeNumber":"+1-800-555-0100",
      "dialinUrl":"url"
   }
}

Ejemplo 2: Actualizar el lobbyBypassSettings

Nota: El identificador de reunión se ha acortado para mejorar la legibilidad.

PATCH https://graph.microsoft.com/beta/me/onlineMeetings/MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi
Content-Type: application/json 

{
  "lobbyBypassSettings": {
      "isDialInBypassEnabled": true
  }
}

Respuesta

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "MSpkYzE3Njc0Yy04MWQ5LTRhZGItYmZi",
    "creationDateTime":"2020-07-03T00:23:39.444642Z",
    "startDateTime":"2020-09-09T21:33:30.8546353Z",
    "endDateTime":"2020-09-09T22:03:30.8566356Z",
    "joinWebUrl":"(redacted)",
    "subject":"Patch Meeting Subject",
    "autoAdmittedUsers": "EveryoneInCompany",
    "isEntryExitAnnounced": true,
    "allowedPresenters": "everyone",
    "videoTeleconferenceId": "(redacted)",
    "participants": {
        "organizer": {
            "upn": "(redacted)",
            "role": "presenter",
            "identity": {
                "user": {
                    "id": "dc17674c-81d9-4adb-bfb2-8f6a442e4622",
                    "displayName": null,
                    "tenantId": "909c6581-5130-43e9-88f3-fcb3582cde38",
                    "identityProvider": "AAD"
                }
            }
        },
        "attendees": [],
    },
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}