Compartir a través de


Actualizar onlineMeeting

Espacio de nombres: microsoft.graph

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 .

Nota:

Si invita a una lista de contactos de más de 150 miembros a una reunión, solo podrán acceder al chat durante la reunión. Si algunas personas de la lista de contactos son asistentes necesarios y el resto son opcionales, agréguelas directamente como participantes. Si agrega una lista de contactos que hace que el chat supere las 1000 personas, no podrá agregar la lista. Para obtener más información, consulte Chat en reuniones de Microsoft Teams.

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

En las tablas siguientes se muestran los permisos o permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga los procedimientos recomendados para solicitar permisos con privilegios mínimos. 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.

Permisos para la siguiente solicitud HTTP:

PATCH /me/onlineMeetings/{meetingId}
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.

Permisos para la siguiente solicitud HTTP:

PATCH /users/{userId}/onlineMeetings/{meetingId}
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 OnlineMeetings.ReadWrite.All No disponible.

Nota:

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:

  • Ajustar 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.
  • Ajustar el campo de 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 Description ¿Se aplica a las reuniones en curso?
allowAttendeeToEnableCamera Booleano Indica si los asistentes pueden activar su cámara.
allowAttendeeToEnableMic Booleano Indica si los asistentes pueden activar su micrófono.
allowBreakoutRooms Booleano Indica si las salas de interrupción están habilitadas para la reunión. No
allowCopyingAndSharingMeetingContent Booleano Indica si la capacidad de copiar y compartir contenido de reunión está habilitada para la reunión.
allowedLobbyAdmitters allowedLobbyAdmitterRoles Especifica los usuarios que pueden admitir desde la sala de espera. Los valores posibles son: organizerAndCoOrganizersAndPresenters, organizerAndCoOrganizers, unknownFutureValue.
allowedPresenters onlineMeetingPresenters Especifica quién puede ser moderador en una reunión.
allowLiveShare meetingLiveShareOptions Indica si el recurso compartido en vivo está habilitado para la reunión. No
allowMeetingChat meetingChatMode Especifica el modo de chat de reunión.
allowPowerPointSharing Booleano Indica si PowerPoint live está habilitado para la reunión. No
allowRecording Booleano Indica si la grabación está habilitada para la reunión. Se hereda de onlineMeetingBase.
allowTeamworkReactions Booleano Indica si las reacciones de Teams están habilitadas para la reunión.
allowTranscription Booleano Indica si la transcripción está habilitada para la reunión. Se hereda de onlineMeetingBase.
allowWhiteboard Booleano Indica si la pizarra está habilitada para la reunión. No
anonymizeIdentityForRoles colección onlineMeetingRole Especifica cuya identidad se anonimiza en la reunión. Los valores posibles son: attendee. El attendee valor no se puede quitar mediante una operación PATCH una vez agregado. Se hereda de onlineMeetingBase. No
endDateTime DateTime Hora de finalización de la reunión en UTC. No
isEndToEndEncryptionEnabled Booleano Indica si el cifrado de un extremo a otro (E2EE) está habilitado para la reunión. No
isEntryExitAnnounced Booleano Si se anuncia o no cuando los autores de llamadas se unen o se van.
lobbyBypassSettings lobbyBypassSettings Especifica qué participantes pueden omitir la sala de reuniones.
meetingSpokenLanguageTag Cadena Especifica el idioma hablado que se usa durante la reunión con fines de grabación y transcripción. No
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
sensitivityLabelAssignment onlineMeetingSensitivityLabelAssignment Especifica la etiqueta de confidencialidad aplicada a la reunión de Teams. No
startDateTime DateTime Hora de inicio de la reunión en UTC. No
subject Cadena Tema de la reunión en línea. No
watermarkProtection watermarkProtectionValues Especifica si la aplicación cliente debe aplicar una marca de agua a un tipo de contenido. Se hereda de onlineMeetingBase. Se hereda de onlineMeetingBase. No
broadcastSettings (en desuso) broadcastMeetingSettings Configuración relacionada con un evento en directo. No

Nota:

  • Para obtener la lista de valores posibles para allowedPresenters, allowLiveShare 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/v1.0/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",
  "meetingSpokenLanguageTag": "en-US"
}

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",
   "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"
            }
         }
      }
   },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "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/v1.0/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": [],
    },
    "sensitivityLabelAssignment": {
      "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
    },
    "meetingSpokenLanguageTag": "en-US",
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": true
    }
}

Ejemplo 3: Habilitación del cifrado de un extremo a otro en una reunión en línea existente

En el ejemplo siguiente se muestra cómo habilitar el cifrado de un extremo a otro en una reunión en línea existente.

Nota: La propiedad isEndToEndEncryptionEnabled debe usarse con directivas de Teams para determinar el comportamiento final y las actualizaciones de directivas pueden tardar hasta 24 horas en aplicarse. Para obtener más información, consulte Requerir cifrado de un extremo a otro para reuniones confidenciales de Teams.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

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

{
  "isEndToEndEncryptionEnabled": true
}

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

{
  "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",
  "isEndToEndEncryptionEnabled": true,
  "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": []
  },
  "sensitivityLabelAssignment": {
    "sensitivityLabelId": "c7f2d7a7-6a36-4a41-9a6b-0d2761a9f4f0"
  },
  "meetingSpokenLanguageTag": "en-US",
  "lobbyBypassSettings": {
    "scope": "organization",
    "isDialInBypassEnabled": true
  }
}