Compartir a través de

onlineMeeting: createOrGet

  • 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.

Cree un objeto onlineMeeting con un identificador externo personalizado especificado. Si el identificador externo ya existe, esta API devolverá el objeto onlineMeeting con ese identificador externo.

Nota: no se muestra la reunión en el calendario del usuario.

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
✅ ❌ ❌ ❌

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) OnlineMeetings.ReadWrite
Delegado (cuenta personal de Microsoft) No admitido.
Aplicación OnlineMeetings.ReadWrite.All*

Importante

* Los administradores deben crear una directiva de acceso a la aplicación y concederla a un usuario, autorizando la aplicación configurada en la directiva para crear o obtener una reunión en línea con un identificador externo en nombre de ese usuario (id. de usuario especificado en la ruta de acceso de la solicitud).

Solicitud HTTP

Para llamar a createOrGet API con token delegado:

POST /me/onlineMeetings/createOrGet

Para llamar a createOrGet API con el token de aplicación:

POST /users/{userId}/onlineMeetings/createOrGet

Nota:

userId es el identificador de objeto de un usuario en Centro de administración Microsoft Entra > página de administración de usuarios. Para obtener más información, consulte la directiva de acceso a la aplicación.

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 el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.

Parámetro Tipo Descripción
chatInfo chatInfo La información de chat asociada a esta reunión en línea.
endDateTime DateTime Hora de finalización de la reunión en UTC.
externalId Cadena Identificador externo. Un identificador personalizado. (Obligatorio)
participants meetingParticipants Los participantes asociados a la reunión en línea. Esto incluye el organizador y los asistentes.
startDateTime DateTime Hora de inicio de la reunión en UTC.
subject Cadena Tema de la reunión en línea.

Notas:

  • Si no se proporcionan startDateTime y endDateTime , el valor predeterminado de startDateTime será el valor dateTime actual y el valor endDateTime será igual a startDateTime + 1 hora.
  • Si se proporciona startDateTime , pero endDateTime no, el valor endDateTime será igual a startDateTime + 1 hora.
  • Se produce un error si endDateTime se proporciona sin startDateTime o si endDateTime es anterior a startDateTime.
  • Actualmente chatInfo solo se admite en la versión beta.
  • Cuando varios usuarios del mismo inquilino usan el mismo externalId para ejecutar esta consulta, se generan distintas instancias de reunión, cada una con su propio identificador único. La combinación de tenantId, userId y externalId actúa como identificador de una reunión con un identificador externo.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta si se crea una nueva reunión o un código de 200 OK respuesta si se recupera una reunión existente. En ambos casos, se devuelve un objeto onlineMeeting en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Creación o obtención de una reunión en línea con un identificador externo

Solicitud

POST https://graph.microsoft.com/beta/me/onlineMeetings/createOrGet
Content-Type: application/json

{
    "startDateTime": "2020-02-06T01:49:21.3524945+00:00",
    "endDateTime": "2020-02-06T02:19:21.3524945+00:00",
    "subject": "Create a meeting with customId provided",
    "externalId": "7eb8263f-d0e0-4149-bb1c-1f0476083c56",
    "participants": {
        "attendees": [
            {
                "identity": {
                    "user": {
                        "id": "1f35f2e6-9cab-44ad-8d5a-b74c14720000"
                    }
                },
                "role": "presenter",
                "upn": "test1@contoso.com"
            }
        ]
    }
}

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": "(redacted)",
    "creationDateTime": "2020-09-11T06:30:18.1909168Z",
    "startDateTime": "2020-09-11T06:30:18.0615989Z",
    "endDateTime": "2020-09-11T07:30:18.0615989Z",
    "joinWebUrl": "(redacted)",
    "subject": "Create a meeting with customId provided",
    "isBroadcast": false,
    "autoAdmittedUsers": "EveryoneInCompany",
    "isEntryExitAnnounced": true,
    "allowedPresenters": "everyone",
    "videoTeleconferenceId": "(redacted)",
    "externalId": "7eb8263f-d0e0-4149-bb1c-1f0476083c56",
    "participants": {
        "organizer": {
            "upn": "(redacted)",
            "role": "presenter",
            "identity": {
                "user": {
                    "id": "(redacted)",
                }
            }
        },
        "attendees": [
            {
                "upn": "test1@contoso.com",
                "role": null,
                "identity": {
                    "user": {
                        "id": "1f35f2e6-9cab-44ad-8d5a-b74c14720000",
                    }
                }
            }
        ],
        "producers": [],
        "contributors": []
    },
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": false
    },
    "audioConferencing": {
        "conferenceId": "(redacted)",
        "tollNumber": "+1 206-485-3005",
        "tollFreeNumber": null,
        "dialinUrl": "https://dialin.teams.microsoft.com/0e73a853-1cc2-436c-b18c-9f53e0a97c24?id=(redacted)"
    },
    "chatInfo": {
        "threadId": "19:7ebda77322dd4505ac4dedb5b67df076@thread.tacv2",
        "messageId": "0",
        "replyChainMessageId": null
    },
}

Ejemplo 2: Creación o obtención de una reunión en línea en un canal de Microsoft Teams con un identificador externo

Solicitud

POST https://graph.microsoft.com/beta/me/onlineMeetings/createOrGet
Content-Type: application/json

{
    "chatInfo": {
        "threadId": "19:7ebda77322dd4505ac4dedb5b67df076@thread.tacv2"
    },
    "startDateTime": "2020-02-06T01:49:21.3524945+00:00",
    "endDateTime": "2020-02-06T02:19:21.3524945+00:00",
    "externalId": "7eb8263f-d0e0-4149-bb1c-1f0476083c56",
    "participants": {
        "attendees": [
            {
                "identity": {
                    "user": {
                        "id": "1f35f2e6-9cab-44ad-8d5a-b74c14720000"
                    }
                },
                "upn": "test1@contoso.com"
            }
        ]
    },
    "subject": "Create a meeting with customId provided"
}

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": "(redacted)",
    "creationDateTime": "2020-09-11T06:30:18.1909168Z",
    "startDateTime": "2020-09-11T06:30:18.0615989Z",
    "endDateTime": "2020-09-11T07:30:18.0615989Z",
    "joinWebUrl": "(redacted)",
    "subject": "Create a meeting with customId provided",
    "isBroadcast": false,
    "autoAdmittedUsers": "EveryoneInCompany",
    "isEntryExitAnnounced": true,
    "allowedPresenters": "everyone",
    "videoTeleconferenceId": "(redacted)",
    "externalId": "7eb8263f-d0e0-4149-bb1c-1f0476083c56",
    "participants": {
        "organizer": {
            "upn": "(redacted)",
            "role": "presenter",
            "identity": {
                "user": {
                    "id": "(redacted)",
                }
            }
        },
        "attendees": [
            {
                "upn": "test1@contoso.com",
                "role": null,
                "identity": {
                    "user": {
                        "id": "1f35f2e6-9cab-44ad-8d5a-b74c14720000",
                    }
                }
            }
        ],
        "producers": [],
        "contributors": []
    },
    "lobbyBypassSettings": {
        "scope": "organization",
        "isDialInBypassEnabled": false
    },
    "audioConferencing": {
        "conferenceId": "(redacted)",
        "tollNumber": "+1 206-485-3005",
        "tollFreeNumber": null,
        "dialinUrl": "https://dialin.teams.microsoft.com/0e73a853-1cc2-436c-b18c-9f53e0a97c24?id=(redacted)"
    },
    "chatInfo": {
        "threadId": "19:7ebda77322dd4505ac4dedb5b67df076@thread.tacv2",
        "messageId": "1599805818399",
        "replyChainMessageId": null
    },
}