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/ Panel de control/ Estadísticas de reuniones/ APIs/ Consulta de estadísticas de asistencia a reuniones en una empresa
Actualización más reciente 2023-01-31 GMT+08:00
Ver PDF

Consulta de estadísticas de asistencia a reuniones en una empresa

Descripción

  • Esta API se utiliza para consultar estadísticas sobre los participantes de una reunión en una empresa por día o mes.
  • Esta API se utiliza para consultar estadísticas de asistencia sobre terminales duros en una empresa por día o mes.
  • Esta API se utiliza para consultar estadísticas sobre dispositivos de reuniones en una empresa por día o mes.
  • Rol de permisos = Empresa de edición Premium/Standard + Administrador

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Dirección de solicitud

/v1/metrics/dashboard/statistic/conference/participant

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

offset

No

Integer

Query

Desplazamiento de consulta.

  • El valor es mayor o igual a 0. El valor predeterminado es 0.
  • Si offset es mayor o igual que el número máximo de registros, se devuelven los datos de la última página. El número de páginas se calcula en función del número total de registros y limit.

limit

No

Integer

Query

Número de registros a consultar.

  • Rango de valores: 1 a 500. El valor predeterminado es 20.

timeUnit

Sí

String

Query

Dimensión de tiempo de consulta. Las opciones son las siguientes:

  • D: por día.
  • M: por mes.

startTime

Sí

String

Query
Hora de inicio de la consulta. El formato depende del valor de timeUnit.
  • Cuando timeUnit se establece en D, el formato es aaaa-MM-dd. En este caso, el intervalo entre startTime y endTime no puede exceder de 31 días.
  • Cuando timeUnit se establece en M, el formato es aaaa-MM. En este caso, el intervalo entre startTime y endTime no puede exceder de 12 meses.

endTime

Sí

String

Query
Hora de finalización de la consulta. El formato depende del valor de timeUnit.
  • Cuando timeUnit se establece en D, el formato es aaaa-MM-dd. En este caso, el intervalo entre startTime y endTime no puede exceder de 31 días.
  • Cuando timeUnit se establece en M, el formato es aaaa-MM. En este caso, el intervalo entre startTime y endTime no puede exceder de 12 meses.

category

Sí

String

Query

Categoría de consulta. Las opciones son las siguientes:

  • user_participate_info: estadísticas de asistencia de usuarios.
  • hard_terminal_participate_info: estadísticas de asistencia al terminal duro.
  • participant_type_info: estadísticas del dispositivo participante.

X-Access-Token

Sí

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.

Códigos de estado

Tabla 3 Códigos de estado

Código de estado de HTTP

Descripción

400

Solicitud incorrecta. Parámetros no válidos.

401

No autorizado. La autenticación no se realiza o falla.

403

Prohibido. Permisos insuficientes.

500

Excepción del servidor.

Parámetros de respuesta

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

count

Integer

Número total de registros.

limit

Integer

Número de registros consultados.

offset

Integer

Desplazamiento de consulta.

data

Array of StatisticParticipateDataItem objects

Consultar la matriz de resultados de los datos de asistencia a reuniones recopilados por punto de tiempo.
Tabla 5 Estructura de datos de StatisticParticipateDataItem

Parámetro

Tipo

Descripción

time

String

Fecha/Mes.

confUserName

String

Nombre del participante.

Este parámetro sólo es válido cuando category está establecida en user_participate_info.

confUserAccount

String

Cuenta de participante.

Este parámetro sólo es válido cuando category está establecida en user_participate_info.

confUserDeptName

String

Departamento al que pertenece el participante.

Este parámetro sólo es válido cuando category está establecida en user_participate_info.

confUserCount

String

Número de veces que el usuario asiste a las reuniones.

Este parámetro sólo es válido cuando category está establecida en user_participate_info.

confUserDuration

String

Duración de la asistencia del participante, en segundos.

Este parámetro sólo es válido cuando category está establecida en user_participate_info.

confHardTerminalName

String

Nombre de un terminal duro.

Este parámetro solo es válido cuando category se establece en hard_terminal_participate_info.

confHardTerminalModel

String

Modelo de terminal duro.

Este parámetro solo es válido cuando category se establece en hard_terminal_participate_info.

confHardTerminalUserId

String

ID de usuario del terminal duro.

Este parámetro solo es válido cuando category se establece en hard_terminal_participate_info.

confHardTerminalCount

String

Número de veces que el terminal duro asiste a las reuniones.

Este parámetro solo es válido cuando category se establece en hard_terminal_participate_info.

confHardTerminalDuration

String

Duración de la asistencia del terminal duro, en segundos.

Este parámetro solo es válido cuando category se establece en hard_terminal_participate_info.

deviceType

String

Tipo de dispositivo de asistencia.

Este parámetro sólo es válido cuando category se establece en participante_type_info.

deviceVersion

String

Device version.

Este parámetro sólo es válido cuando category se establece en participante_type_info.

deviceAttendanceCount

String

Número de veces que el dispositivo asiste a reuniones.

Este parámetro sólo es válido cuando category se establece en participante_type_info.

Ejemplo de solicitud

GET /v1/metrics/dashboard/statistic/conference/participant?timeUnit=D&startTime=2021-04-01&endTime=2021-04-30&category=user_participate_info&offset=0&limit=4
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)

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: 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": 3,
	"limit": 4,
	"offset": 0,
	"data": [{
			"time": "2021-04-18",
			"confUserName": "linghaiwen",
			"confUserAccount": "lingwenhai",
			"confUserDeptName": "1",
			"confUserCount": "1",
			"confUserDuration": "53"
		},
		{
			"time": "2021-04-19",
			"confUserName": "zhaoyuwei",
			"confUserAccount": "haiwenling",
			"confUserDeptName": "lingwenhai",
			"confUserCount": "3",
			"confUserDuration": "33"
		},
		{
			"time": "2021-04-19",
			"confUserName": "linghaiwen",
			"confUserAccount": "lingwenhai",
			"confUserDeptName": "lingwenhai",
			"confUserCount": "2",
			"confUserDuration": "22"
		}
	]
}

Códigos de error

Si se devuelve un código de error que comienza con MBI cuando usa 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 -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' -s "https://api.meeting.huaweicloud.com/v1/metrics/dashboard/statistic/conference/participant?timeUnit=D&startTime=2021-04-01&endTime=2021-04-30&category=user_participate_info&offset=0&limit=4"
Tema principal: APIs