Compartir a través de

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.

Para obtener la lista de propiedades que admiten la actualización, consulte la sección Cuerpo de la solicitud .

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, proporcione solo los valores de las propiedades que se deben actualizar, con las siguientes excepciones:

  • Si actualiza la fecha y hora de inicio o finalización de una reunión en línea, siempre debe incluir 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.
  • Si actualiza el campo de asistentes de la propiedad participants , como agregar o quitar un asistente a la reunión, siempre debe incluir la lista completa de asistentes en el cuerpo de la solicitud.

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

Propiedad Tipo Descripción ¿Se aplica a las reuniones en curso?
allowAttendeeToEnableCamera Booleano Indica si los asistentes pueden activar su cámara. Yes
allowAttendeeToEnableMic Booleano Indica si los asistentes pueden activar su micrófono. Yes
allowBreakoutRooms Booleano Indica si las salas de interrupción están habilitadas para la reunión. No
allowedLobbyAdmitters allowedLobbyAdmitterRoles Especifica los usuarios que pueden admitir desde la sala de espera. Los valores posibles son: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers y unknownFutureValue. Yes
allowedPresenters onlineMeetingPresenters Especifica quién puede ser moderador en una reunión. Yes
allowLiveShare Booleano Indica si el recurso compartido en vivo está habilitado para la reunión. No
allowMeetingChat meetingChatMode Especifica el modo de chat de reunión. Yes
allowPowerPointSharing Booleano Indica si PowerPoint live está habilitado para la reunión. No
allowTeamworkReactions Booleano Indica si las reacciones de Teams están habilitadas para la reunión. Yes
allowWhiteboard Booleano Indica si la pizarra está habilitada para la reunión. No
endDateTime DateTime Hora de finalización de la reunión en UTC. No
isEntryExitAnnounced Booleano Si se anuncia o no cuando los autores de llamadas se unen o se van. Yes
lobbyBypassSettings lobbyBypassSettings Especifica qué participantes pueden omitir la sala de reuniones. Yes
participants meetingParticipants Los participantes asociados a la reunión en línea. Solo se pueden actualizar los asistentes. No
recordAutomatically Booleano Indica si se va a grabar la reunión automáticamente. No
startDateTime DateTime Hora de inicio de la reunión en UTC. No
subject Cadena Tema de la reunión en línea. 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
    }
}