Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Gestión de reuniones/ APIs/ Modificación de una serie de reuniones recurrentes
Actualización más reciente 2023-01-31 GMT+08:00

Modificación de una serie de reuniones recurrentes

Descripción

Esta API se utiliza para modificar una próxima serie de reuniones recurrentes.

Al modificar los parámetros de reunión, configure todos los parámetros necesarios cuando se programe la reunión. Si solo especifica los parámetros que se van a modificar, otros parámetros se restaurarán a los valores predeterminados.

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

PUT

Dirección de solicitud

/v1/mmc/management/cycleconferences

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

conferenceID

String

Query

ID de reunión.

userUUID

No

String

Query

UUID del usuario (registrado en el USG).

X-Access-Token

String

Header

Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación.

Nota:

  • El valor corresponde al encabezado X-Auth-Token de la documentación. Para obtener más información, consulta el encabezado X-Auth-Token en la descripción de la API de Server API Reference.

X-Authorization-Type

No

String

Header

Si la solicitud se envía desde un portal de terceros.

X-Site-Id

No

String

Header

ID del sitio HCS Online donde se realiza la autenticación.

startTime

No

String

Body

Hora UTC cuando comienza la reunión.

NOTA:

Si no especifica este parámetro al programar una reunión, la reunión comenzará inmediatamente.

Formato: aaaa-MM-dd HH:mm.

length

No

Integer

Body

Duración de la reunión, en minutos. Rango de valores: 15 a 1440. Valor predeterminado: 30.

subject

No

String

Body

Tema de la reunión. El valor puede contener hasta 128 caracteres.

mediaTypes

String

Body

Tipo de medios de comunicación de la reunión.

El valor consta de uno o varios valores enumerados, que están separados por comas (,). Los valores enumerados son los siguientes:

  • Voice: voz.
  • Video: Vídeo SD.
  • HDVideo: Vídeo HD (Este valor enumerado y Video son mutuamente excluyentes. Si se especifican ambos valores, el sistema utiliza Video).
  • Telepresence: telepresencia (Este valor enumerado es mutuamente excluyente con HDVideo y Video. Si se especifican los tres valores, el sistema utiliza Telepresence.) Este campo está reservado.
  • Data: multimedia (Este valor enumerado viene determinado por la configuración del sistema.)

groupuri

No

String

Body

ID de grupo temporal utilizado cuando se crea una reunión instantánea en el cliente. Este parámetro se incluye en el encabezado de conference-info o cuando se invita a otros participantes. El valor puede contener hasta 31 caracteres.

attendees

No

Array of Attendee objects

Body

Lista de participantes, que se puede utilizar para enviar notificaciones y recordatorios de reuniones y que la plataforma de gestión de Huawei Cloud Meeting puede usar para invitar automáticamente a los participantes a la hora de inicio de la reunión.

cycleParams

No

CycleParams object

Body

Lista de parámetros de reunión recurrente, que es obligatoria para una serie de reuniones recurrentes.

La lista de parámetros incluye la fecha de inicio, la fecha de finalización, el intervalo y la hora de inicio de la serie de reuniones periódicas.

isAutoRecord

No

Integer

Body

Si se iniciará automáticamente la grabación para la reunión. Este parámetro sólo es válido cuando recordType se establece en 2 o 3. Valor predeterminado: 0.

  • 1: La grabación se inicia automáticamente.
  • 0: La grabación no se inicia automáticamente.

encryptMode

No

Integer

Body

Modo de encriptación de medios de reunión. El valor predeterminado se define en la configuración de nivel empresarial.

  • 0: encriptación adaptativa.
  • 1: encriptación forzada.
  • 2: no encriptado.

language

No

String

Body

Idioma predeterminado de la reunión. El valor predeterminado lo define el servidor de Huawei Cloud Meeting.

Los idiomas compatibles con la plataforma de gestión de Huawei Cloud Meeting se transmiten como se especifica en el RFC 3066 común.

  • zh-CN: chino simplificado.
  • es-US: Inglés (EE.UU.).

timeZoneID

No

String

Body

Zona horaria de la reunión en las notificaciones de la reunión. Para obtener más información, consulte Asignación de zona horaria.

NOTA:
  • Por ejemplo, si timeZoneID se establece en 26, la hora en la notificación de reunión enviada por la reunión en la nube de Huawei es Tue, Nov 11, 2021 00:00 - 02:00 (GMT) Greenwich Mean Time:Dublin, Edinburgh, Lisbon, London.
  • Si la notificación de la reunión es enviada por un sistema de terceros, deje este parámetro en blanco.

recordType

No

Integer

Body

Tipo de grabación. Valor predeterminado: 0.

  • 0: no hay grabación.
  • 1: transmisión en vivo.
  • 2: grabación.
  • 3: transmisión en vivo y grabación.

liveAddress

No

String

Body

Dirección de transmisión en vivo del vídeo. El valor puede contener hasta 255 caracteres. Este parámetro sólo es válido cuando recordType se establece en 2 o 3.

auxAddress

No

String

Body

Dirección de transmisión en directo de la presentación. El valor puede contener hasta 255 caracteres. Este parámetro sólo es válido cuando recordType se establece en 2 o 3.

recordAuxStream

No

Integer

Body

Si desea grabar la presentación. Este parámetro sólo es válido cuando recordType se establece en 2 o 3.

  • 0: No grabar la presentación.
  • 1: Grabar la presentación.

confConfigInfo

No

ConfConfigInfo object

Body

Otras configuraciones de reunión.

recordAuthType

No

Integer

Body

Modo de autenticación de grabación. Este parámetro sólo es válido cuando recordType se establece en 2 o 3.

  • 0: Los usuarios que obtengan el enlace de la grabación pueden ver o descargar la grabación.
  • 1: Solo los usuarios empresariales pueden ver o descargar la grabación.
  • 2: Solo los participantes de la reunión pueden ver y descargar la grabación.

vmrFlag

No

Integer

Body

Si se debe utilizar una sala de reuniones en la nube para celebrar la reunión programada. Valor predeterminado: 0.

  • 0: No utilice ninguna sala de reuniones en la nube.
  • 1: Utilice una sala de reuniones en la nube.

vmrID

No

String

Body

ID de la sala de reuniones en la nube utilizada para celebrar la reunión. El valor puede contener hasta 512 caracteres.

  • Si se especifica este parámetro, la ID se utiliza para consultar salas de reuniones en la nube.
  • Si este parámetro está vacío, se consultan todas las salas de reuniones en la nube del usuario. Si hay disponible una ID de reunión personal, se utiliza la ID de reunión personal. Si no hay ninguna ID de reunión personal disponible, se utiliza la ID de sala de reuniones en la nube más pequeño.

concurrentParticipants

No

Integer

Body

Número máximo de participantes en la reunión.

  • 0: ilimitado.
  • > 0

Códigos de estado

Tabla 3 Códigos de estado

Código de estado de HTTP

Descripción

200

Operación exitosa.

400

Parámetros no válidos.

401

La autenticación no se realiza o falla.

403

Permisos insuficientes.

500

Excepción del servidor.

Parámetros de respuesta

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

[Array element]

Array of ConferenceInfo

Lista de información de la reunión.

Ejemplo de solicitud

PUT /v1/mmc/management/cycleconferences?conferenceID=914087436
Connection: keep-alive
X-Access-Token: cnr1510zTBhrfUsymQ0srhW2RYS99r9G5SQoTLWN
Content-Type: application/json
user-agent: WeLink-desktop
Content-Length: 372
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

{
    "mediaTypes": "HDVideo",
    "cycleParams": {
        "startDate": "2021-09-01",
        "endDate": "2021-09-02",
        "cycle": "Day",
        "preRemindDays": 1
    }
}

Ejemplo de respuesta

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 2164
Connection: keep-alive
http_proxy_id: 462abfcfa8a41c2c5450eb7648bf5ad2
Server: api-gateway
X-Request-Id: 7ba6f742610c03a64262b126fb336a5d

[
    {
        "conferenceID": "986256843",
        "mediaTypes": "HDVideo,Data,Voice",
        "subject": "Conference Topic",
        "size": 0,
        "timeZoneID": "56",
        "startTime": "2021-09-01 08:46",
        "endTime": "2021-09-01 09:16",
        "conferenceState": "Schedule",
        "accessNumber": "+86571150",
        "language": "zh-CN",
        "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "999712"
            },
            {
                "conferenceRole": "general",
                "password": "891009"
            }
        ],
        "userUUID": "fe235be7aa6045b98a33f27b365cbca9",
        "scheduserName": "Suzhou Branch",
        "multiStreamFlag": 1,
        "conferenceType": 2,
        "confType": "CYCLE",
        "cycleParams": {
            "startDate": "2021-09-01",
            "cycle": "Day",
            "endDate": "2021-09-02",
            "cycleCount": 0,
            "interval": 1,
            "preRemindDays": 1
        },
        "isAutoMute": 0,
        "isHardTerminalAutoMute": 0,
        "isSoftTerminalAutoMute": 0,
        "isAutoRecord": 0,
        "chairJoinUri": "https://100.95.188.184:443/#/j/986256843/fa4def332cb83f5b1ec74c64d0658a8570f45ad3e8d0df8c",
        "guestJoinUri": "https://100.95.188.184:443/#/j/986256843/53f55ec44263d666e8ed70594624aa10497c631a91d3b8c1",
        "recordType": 0,
        "recordAuxStream": 0,
        "recordAuthType": 2,
        "confConfigInfo": {
            "inviteMode": "AUTO_INVITE",
            "prolongLength": 15,
            "isGuestFreePwd": false,
            "isSendNotify": true,
            "isSendSms": true,
            "isSendCalendar": true,
            "isAutoMute": false,
            "isHardTerminalAutoMute": false,
            "callInRestriction": 0,
            "audienceCallInRestriction": 0,
            "allowGuestStartConf": true,
            "enableWaitingRoom": false
        },
        "vmrFlag": 0,
        "scheduleVmr": false,
        "isHasRecordFile": false,
        "terminlCount": 0,
        "normalCount": 0,
        "deptName": "corpzxytest111",
        "confMode": "RTC",
        "webinar": false,
        "concurrentParticipants": 0,
        "subConfs": [
            {
                "cycleSubConfID": "ff1cf7020a3711ecbe71e167f3b9d5b1",
                "conferenceID": "986256843",
                "startTime": "2021-09-01 08:46",
                "endTime": "2021-09-01 09:16",
                "mediaType": "HDVideo,Data,Voice",
                "isAutoRecord": 0,
                "recordAuthType": 2,
                "confConfigInfo": {
                    "callInRestriction": 0,
                    "audienceCallInRestriction": 0,
                    "allowGuestStartConf": true,
                    "enableWaitingRoom": false
                }
            },
            {
                "cycleSubConfID": "ff1cf7030a3711ecbe7183f6162d654d",
                "conferenceID": "986256843",
                "startTime": "2021-09-02 08:46",
                "endTime": "2021-09-02 09:16",
                "mediaType": "HDVideo,Data,Voice",
                "isAutoRecord": 0,
                "recordAuthType": 2,
                "confConfigInfo": {
                    "callInRestriction": 0,
                    "audienceCallInRestriction": 0,
                    "allowGuestStartConf": true,
                    "enableWaitingRoom": false
                }
            }
        ]
    }
]

Códigos de error

Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en Centro de errores de la API de Huawei Cloud.

Ejemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token:cnr1510zTBhrfUsymQ0srhW2RYS99r9G5SQoTLWN' -d '{"mediaTypes": "HDVideo","cycleParams": {"startDate": "2021-09-01","endDate": "2021-09-02","cycle": "Day","preRemindDays": 1}}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/cycleconferences?conferenceID=986256843'