Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento de reunião/ APIs/ Modificação de uma reunião agendada
Atualizado em 2023-08-02 GMT+08:00
Ver PDF

Modificação de uma reunião agendada

Descrição

Esta API é usada para modificar uma reunião agendada. As reuniões em andamento não podem ser modificadas.

Ao modificar os parâmetros da reunião, configure todos os parâmetros necessários para agendar a reunião. Se você especificar somente os parâmetros a serem modificados, outros parâmetros serão restaurados para os valores padrão.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

PUT

Endereço de solicitação

/v1/mmc/management/conferences

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

conferenceID

Sim

String

Consulta

ID da reunião.

userUUID

Não

String

Consulta

UUID do usuário (registrado no USG).

X-Access-Token

Sim

String

Cabeçalho

Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.

X-Authorization-Type

Não

String

Cabeçalho

Se a solicitação é enviada de um portal de terceiros.

X-Site-Id

Não

String

Cabeçalho

ID do site do HCS on-line onde a autenticação é realizada.

startTime

Não

String

Corpo

Hora UTC quando a reunião começa.

NOTA:

Se você não especificar esse parâmetro ao agendar uma reunião, a reunião será iniciada imediatamente.

Formato: aaaa-MM-dd HH:mm.

length

Não

Integer

Corpo

Duração da reunião, em minutos. Intervalo de valores: 15 até 1440. Valor padrão: 30.

subject

Não

String

Corpo

Tópico da reunião. O valor pode conter até 128 caracteres.

mediaTypes

Sim

String

Corpo

Tipo de mídia da reunião.

O valor consiste em um ou vários valores enumerados, que são separados por vírgulas (,). Os valores enumerados são os seguintes:

  • Voice: voz.
  • Video: vídeo SD.
  • HDVideo: vídeo HD (Este valor enumerado e Video são mutuamente exclusivos. Se ambos os valores forem especificados, o sistema usará Video.)
  • Telepresence: telepresença (Este valor enumerado é mutuamente exclusivo com HDVideo e Video. Se todos os três valores forem especificados, o sistema usará Telepresence.) Este campo está reservado.
  • Data: multimídia (Este valor enumerado é determinado pela configuração do sistema.)

groupuri

Não

String

Corpo

ID de grupo temporário usado quando uma reunião instantânea é criada no cliente. Este parâmetro é transportado no cabeçalho conference-info ou quando outros participantes são convidados. O valor pode conter até 31 caracteres.

attendees

Não

Array of Attendee objects

Corpo

Lista de participantes, que pode ser usada para enviar notificações e lembretes de reuniões e ser usada pela Plataforma de gerenciamento do Huawei Cloud Meeting para convidar automaticamente participantes na hora de início da reunião.

cycleParams

Não

CycleParams object

Corpo

Lista de parâmetros de reuniões recorrentes, que é obrigatória para uma série de reuniões recorrentes.

A lista de parâmetros inclui a data de início, a data de término, o intervalo e a hora de início da série de reuniões recorrentes.

isAutoRecord

Não

Integer

Corpo

Se iniciar automaticamente a gravação para a reunião. Este parâmetro é válido somente quando recordType é definido como 2 ou 3. Valor padrão: 0.

  • 1: a gravação é iniciada automaticamente.
  • 0: a gravação não é iniciada automaticamente.

encryptMode

Não

Integer

Corpo

Modo de criptografia de mídia de reunião. O valor padrão é definido na configuração de nível empresarial.

  • 0: criptografia adaptativa.
  • 1: criptografia forçada.
  • 2: não criptografado.

language

Não

String

Corpo

Idioma padrão da reunião. O valor padrão é definido pelo servidor do Huawei Cloud Meeting.

Os idiomas suportados pela Plataforma de gerenciamento do Huawei Cloud Meeting são transmitidos conforme especificado no RFC 3066 comum.

  • zh-CN: chinês simplificado.
  • en-US: inglês (EUA).

timeZoneID

Não

String

Corpo

Fuso horário de reunião em notificações de reunião. Para obter detalhes, consulte Mapeamento de fuso horário.

NOTA:
  • Por exemplo, se timeZoneID estiver definido como 26, o horário na notificação de reunião enviada pelo Huawei Cloud Meeting é Tue, Nov 11, 2021 00:00 - 02:00 (GMT) Greenwich Mean Time:Dublin, Edinburgh, Lisbon, London.
  • Se a notificação de reunião for enviada por um sistema de terceiros, deixe este parâmetro em branco.

recordType

Não

Integer

Corpo

Tipo de gravação. Valor padrão: 0.

  • 0: não gravando.
  • 1: transmissão ao vivo.
  • 2: gravando.
  • 3: transmissão ao vivo e gravando.

liveAddress

Não

String

Corpo

Endereço de transmissão ao vivo do vídeo. O valor pode conter até 255 caracteres. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

auxAddress

Não

String

Corpo

Endereço de transmissão ao vivo da apresentação. O valor pode conter até 255 caracteres. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

recordAuxStream

Não

Integer

Corpo

Se gravar a apresentação. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

  • 0: não grave a apresentação.
  • 1: grave a apresentação.

confConfigInfo

Não

ConfConfigInfo object

Corpo

Outras configurações de reunião.

recordAuthType

Não

Integer

Corpo

Modo de autenticação de gravação. Este parâmetro é válido somente quando recordType é definido como 2 ou 3.

  • 0: os usuários que obtiverem o link da gravação podem assistir ou baixar a gravação.
  • 1: somente usuários empresariais podem assistir ou baixar a gravação.
  • 2: somente os participantes da reunião podem visualizar e baixar a gravação.

vmrFlag

Não

Integer

Corpo

Se usar uma sala de reunião em nuvem para realizar a reunião agendada. Valor padrão: 0.

  • 0: não use nenhuma sala de reunião na nuvem.
  • 1: use uma sala de reunião na nuvem.

vmrID

Não

String

Corpo

ID da sala de reunião na nuvem usada para realizar a reunião. O valor pode conter até 512 caracteres.

  • Se esse parâmetro for especificado, o ID será usado para consultar salas de reunião na nuvem.
  • Se esse parâmetro estiver vazio, todas as salas de reunião em nuvem do usuário serão consultadas. Se um ID de reunião pessoal estiver disponível, o ID de reunião pessoal será usado. Se nenhum ID de reunião pessoal estiver disponível, o menor ID de sala de reunião na nuvem será usado.

concurrentParticipants

Não

Integer

Corpo

Número máximo de participantes na reunião.

  • 0: ilimitado.
  • > 0

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é executada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

[Array element]

Array of ConferenceInfo

Lista de informações da reunião.

Exemplo de solicitação

PUT /v1/mmc/management/conferences?conferenceID=914087436
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
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": "Video,Voice",
    "startTime": "2019-12-23 00:00",
    "length": 120,
    "attendees": [
        {
            "accountId": "user01",
            "name": "user01",
            "role": "0",
            "phone": "+991116003815",
            "isMute": "1"
        }
    ],
    "subject": "user01's meeting"
}

Exemplo de resposta

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

[
    {
        "conferenceID": "914087436",
        "mediaTypes": "Data,Video,Voice",
        "subject": "user01's meeting",
        "size": 1,
        "timeZoneID": "56",
        "startTime": "2019-12-23 00:00",
        "endTime": "2019-12-23 02:00",
        "conferenceState": "Schedule",
        "accessNumber": "+991117",
        "language": "zh-CN",
        "passwordEntry": [
            {
                "conferenceRole": "chair",
                "password": "881824"
            },
            {
                "conferenceRole": "general",
                "password": "787209"
            }
        ],
        "userUUID": "ff808081699b56cb0169be103500012b",
        "scheduserName": "user8002",
        "multiStreamFlag": 1,
        "conferenceType": 0,
        "confType": "FUTURE",
        "isAutoMute": 1,
        "isAutoRecord": 0,
        "chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/914087436/411170cda30af7327be723ef63d5ab8900a3b773be496604",
        "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/914087436/052ee23f08966bc6221fc363500e9843f2356349de9d106c",
        "recordType": 0,
        "recordAuxStream": 0,
        "confConfigInfo": {
            "isSendNotify": true,
            "isSendSms": true,
            "isAutoMute": true
        },
        "vmrFlag": 0,
        "scheduleVmr": false,
        "isHasRecordFile": false,
        "partAttendeeInfo": [
            {
                "phone": "+991116003815",
                "name": "user01",
                "type": "normal"
            }
        ],
        "terminlCount": 0,
        "normalCount": 1,
        "deptName": "wangyue"
    }
]

Códigos de erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -H 'content-type: application/json' -X PUT -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -d '{"mediaTypes": "Voice","attendees": [{"name": "user02","role": 1,"phone": "+8657*******"}],"conferenceType": "0","subject": "user02 conference"}' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences?conferenceID=914087436'
Tópico principal: APIs