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/ Painel de controle/ Estatísticas da reunião/ APIs/ Consulta de estatísticas gerais sobre reuniões em uma empresa
Atualizado em 2023-08-02 GMT+08:00
Ver PDF

Consulta de estatísticas gerais sobre reuniões em uma empresa

Descrição

  • Esta API é usada para consultar estatísticas gerais sobre reuniões em uma empresa dentro de um intervalo de tempo específico por dia ou mês.
  • Esta API é usada para consultar estatísticas de reuniões diárias em uma empresa por hora.

    Função de permissão = edição empresarial Premium/Standard + administrador

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

GET

Endereço de solicitação

/v1/metrics/dashboard/statistic/conference/info

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

offset

Não

Integer

Consulta

Deslocamento de consulta.

  • O valor é maior ou igual a 0. O valor padrão é 0.
  • Se offset for maior ou igual ao número máximo de registros, os dados na última página serão retornados. O número de páginas é calculado com base no número total de registros e limit.

limit

Não

Integer

Consulta

Número de registros a serem consultados.

  • Intervalo de valores: 1 a 500. O valor padrão é 20.

timeUnit

Sim

String

Consulta

Dimensão de tempo de consulta. As opções são as seguintes:

  • D: por dia.
  • M: por mês.

startTime

Sim

String

Consulta
Hora de início da consulta. O formato depende do valor de timeUnit.
  • Quando timeUnit é definido como D, o formato é aaaa-MM-dd. Nesse caso, o intervalo entre startTime e endTime não pode exceder 31 dias.
  • Quando timeUnit é definido como M, o formato é aaaa-MM. Nesse caso, o intervalo entre startTime e endTime não pode exceder 12 meses.

endTime

Sim

String

Consulta
Hora de fim da consulta. O formato depende do valor de timeUnit.
  • Quando timeUnit é definido como D, o formato é aaaa-MM-dd. Nesse caso, o intervalo entre startTime e endTime não pode exceder 31 dias.
  • Quando timeUnit é definido como M, o formato é aaaa-MM. Nesse caso, o intervalo entre startTime e endTime não pode exceder 12 meses.

category

Sim

String

Consulta

Categoria da consulta. As opções são as seguintes:

  • conference_info: dados gerais da reunião.
  • conference_hourly_info: dados gerais da reunião em um único dia.
  • Quando category é definida como conference_hourly_info, o valor de timeUnit só pode ser D, e os valores de startTime e endTime devem ser do mesmo dia.

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.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

400

Solicitação inválida. Parâmetros inválidos.

401

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

403

Proibido. Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

count

Integer

Número total de registros.

limit

Integer

Número de registros consultados.

offset

Integer

Deslocamento de consulta.

data

Array of StatisticConferenceDataItem objects

Matriz de resultados de consulta de dados gerais de reunião coletados por ponto de tempo.
Tabela 5 Estrutura de dados StatisticConferenceDataItem

Parâmetro

Tipo

Descrição

time

String

Data/mês, que é válido somente quando category é definida como conference_info.

Hora, que é válida apenas quando category é definida como conference_hourly_info.

confCount

String

Número de reuniões (incluindo salas de reunião em nuvem).

Esse parâmetro é válido somente quando category é definida como conference_info.

confDuration

String

Duração das reuniões (incluindo salas de reunião na nuvem), em segundos.

Esse parâmetro é válido somente quando category é definida como conference_info.

attendeeCount

String

Número de participantes em reuniões (incluindo salas de reuniões na nuvem).

Esse parâmetro é válido somente quando category é definida como conference_info.

confConcurrentUsedCount

String

Número de recursos de participantes concorrentes usados.

Esse parâmetro é válido somente quando category é definida como conference_info.

conf24hCount

String

Número de reuniões por hora (incluindo salas de reuniões em nuvem).

Esse parâmetro é válido somente quando category é definida como conference_hourly_info.

conf24hAttendeeCount

String

Número de participantes por hora (incluindo salas de reunião na nuvem).

Esse parâmetro é válido somente quando category é definida como conference_hourly_info.

Exemplo de solicitação

GET /v1/metrics/dashboard/statistic/conference/info?timeUnit=D&startTime=2021-03-02&endTime=2021-03-03&category=conference_info&offset=0&limit=20
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

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: 2450
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 6fba0eff9f832b463580fb06c5b0ff9c
Server: api-gateway
X-Request-Id: ac9f75ec3c97c823f128526a924532b2
{
	"count": 2,
	"limit": 10,
	"offset": 0,
	"data": [{
			"time": "2021-03-02",
			"confCount": "122",
			"confDuration": "1124",
			"attendeeCount": "261",
			"confConcurrentUsedCount": "11"
		},
		{
			"time": "2021-03-03",
			"confCount": "122",
			"confDuration": "1124",
			"attendeeCount": "261",
			"confConcurrentUsedCount": "11"
		}
	]
}

Códigos de erro

Se um código de erro começando com MBI 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 -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -s "https://api.meeting.huaweicloud.com/v1/metrics/dashboard/statistic/conference/info?timeUnit=D&startTime=2021-03-02&endTime=2021-03-03&category=conference_info&offset=0&limit=20"
Tópico principal: APIs