Compartir a través de


reportRoot: getSkypeForBusinessOrganizerActivityUserCounts

Espacio de nombres: microsoft.graph

Obtiene tendencias de uso sobre el número de usuarios únicos y el tipo de sesiones de conferencia realizadas y organizadas por los usuarios de la organización. Entre los tipos de sesiones de conferencia se incluyen mensajería instantánea, audio/vídeo, uso compartido de aplicaciones, web, acceso telefónico local o de salida: terceros y acceso telefónico local/salida de Microsoft.

Nota: Para obtener más información sobre los diferentes nombres y vistas de informe, consulte Informes de Microsoft 365: Skype Empresarial actividad del organizador de conferencias.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Reports.Read.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Reports.Read.All No disponible.

Nota: Para que los permisos delegados permitan a las aplicaciones leer informes de uso del servicio en nombre de un usuario, el administrador de inquilinos debe haber asignado al usuario el rol de administrador Microsoft Entra limitado adecuado. Para obtener más información, consulte Autorización para que las API lean los informes de uso de Microsoft 365.

Solicitud HTTP

GET /reports/getSkypeForBusinessOrganizerActivityUserCounts(period='{period_value}')

Parámetros de función

En la URL de la solicitud, especifique el siguiente parámetro de consulta con un valor válido.

Parámetro Tipo Descripción
period cadena Especifica la duración de tiempo durante la que se agrega el informe. Los valores admitidos para {period_value} son: D7, D30, D90 y D180. Estos valores tienen el formato Dn, donde n representa el número de días durante los que se agrega el informe. Necesario.

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
If-None-Match Si se incluye el encabezado de la solicitud y la eTag proporcionada coincide con la etiqueta actual del archivo, se devuelve un código de respuesta 304 Not Modified. Opcional.

Respuesta

Si se ejecuta correctamente, este método devuelve una respuesta 302 Found que redirige a una URL de descarga con autenticación previa para el informe. La URL se encuentra en el encabezado Location de la respuesta.

Las direcciones URL de descarga autenticadas previamente solo son válidas durante un breve período de tiempo (unos minutos) y no requieren un Authorization encabezado.

El archivo CSV tiene los siguientes encabezados de columna.

  • Fecha de actualización del informe
  • Fecha del informe
  • Período del informe
  • Mensajería instantánea
  • Audio o vídeo
  • Uso compartido de aplicaciones
  • Web
  • Acceso telefónico/salida de terceros
  • Acceso telefónico local o aceptación de llamada de Microsoft

Ejemplo

Solicitud

Este es un ejemplo de la solicitud.

GET https://graph.microsoft.com/v1.0/reports/getSkypeForBusinessOrganizerActivityUserCounts(period='D7')

Respuesta

Este es un ejemplo de la respuesta:

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

Siga el redireccionamiento 302 y el archivo CSV que descarga tiene el siguiente esquema.

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,Report Date,Report Period,IM,Audio/Video,App Sharing,Web,Dial-in/out 3rd Party,Dial-in/out Microsoft