- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de autorización
- Pruébalo
Negocia una conexión WebRTC a la conferencia activa de un espacio.
Si se realiza correctamente, los clientes deben usar la respuesta SDP (protocolo de descripción de sesión) resultante para establecer una conexión WebRTC. Una vez que se establece la conexión, se habilitan funciones adicionales en los canales de datos de WebRTC.
Solicitud HTTP
POST https://meet.googleapis.com/v2beta/{name=spaces/*}:connectActiveConference
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
name |
Obligatorio. Es el nombre del recurso del espacio. Formato: spaces/{spaceId} |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "offer": string } |
Campos | |
---|---|
offer |
Obligatorio. Oferta de SDP (protocolo de descripción de sesión) de WebRTC del cliente. El formato se define en la RFC 8866 con claves obligatorias definidas en la RFC 8829. Este es el formato SDP estándar que generan los métodos createOffer() y createAnswer() de una conexión entre pares. |
Cuerpo de la respuesta
Respuesta del método spaces.connectActiveConference.
Una respuesta correcta no indica que la reunión se haya unido por completo. Se debe realizar más comunicación a través de WebRTC.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "answer": string, "traceId": string } |
Campos | |
---|---|
answer |
Respuesta de SDP de WebRTC a la oferta. |
trace |
Es el ID de seguimiento para depurar. Incluye este valor cuando envíes informes de errores. |
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/meetings.conference.media.readonly
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly
https://www.googleapis.com/auth/meetings.conference.media.video.readonly
Para obtener más información, consulta OAuth 2.0 Overview.