reportRoot: getSkypeForBusinessOrganizerActivityCounts
Пространство имен: microsoft.graph
Важно!
API версии /beta
в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.
Отслеживайте динамику использования по количеству и типу проведенных и организованных конференций Типы сеансов конференции включают обмен мгновенными сообщениями, аудио- и видео, общий доступ к приложениям, веб-подключение, подключение и исходящий телефонный доступ сторонних поставщиков, а также подключение к телефонным подключениям и выходу майкрософт.
Заметка: Дополнительные сведения о различных представлениях и именах отчетов см. в статье Отчеты Microsoft 365 — действия организатора конференции Skype для бизнеса.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ✅ |
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | Reports.Read.All | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Для приложений | Reports.Read.All | Недоступно. |
Примечание. Чтобы делегированные разрешения разрешали приложениям читать отчеты об использовании служб от имени пользователя, администратор клиента должен назначить пользователю соответствующую ограниченную роль администратора Microsoft Entra ID. Дополнительные сведения см. в разделе Авторизация api для чтения отчетов об использовании Microsoft 365.
HTTP-запрос
GET /reports/getSkypeForBusinessOrganizerActivityCounts(period='{period_value}')
Параметры функции
В URL-адресе запроса укажите приведенный ниже параметр и действительное значение.
Параметр | Тип | Описание |
---|---|---|
period | string | Указывает отчетный период. Поддерживаемые значения {period_value}: D7, D30, D90 и D180. Эти значения указываются в формате Dn, где n — количество дней в отчетном периоде. Обязательный. |
Этот метод поддерживает $format
параметр запроса OData для настройки ответа. Тип выходных данных по умолчанию — text/csv. Однако если вы хотите указать тип выходных данных, можно использовать параметр запроса OData $format, для которого задано значение text/csv или application/json.
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Отклик
CSV
В случае успешного выполнения этот метод возвращает отклик 302 Found
, который перенаправляет на URL-адрес, для которого выполнена предварительная аутентификация, для скачивания отчета. Этот URL-адрес можно найти в заголовке Location
отклика.
URL-адреса загрузки с предварительной проверкой подлинности действительны только в течение короткого периода времени (несколько минут) и не требуют заголовка Authorization
.
CSV-файл содержит столбцы со следующими заголовками:
- "Report Refresh Date" (Дата обновления отчета);
- "Report Date" (Дата отчета);
- "Report Period" (Отчетный период);
- "IM" (Обмен мгновенными сообщениями);
- "Audio/Video" (Аудио и видео);
- "App Sharing" (Общий доступ к приложениям);
- Web
- Сторонний поставщик с телефонным подключением и выходом
- "Dial-in/out Microsoft" (Конференции с возможностью присоединения по прямому или обратному звонку, корпорация Майкрософт).
JSON
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и объект JSON в тексте отклика.
Пример
CSV
Ниже приведен пример вывода CSV-файла.
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/reports/getSkypeForBusinessOrganizerActivityCounts(period='D7')?$format=text/csv
Отклик
Ниже показан пример отклика.
HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe
Следуйте перенаправлению 302 и CSV-файл, который загружается, имеет следующую схему.
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
JSON
Ниже приведен пример, возвращающий JSON.
Запрос
Ниже показан пример запроса.
GET https://graph.microsoft.com/beta/reports/getSkypeForBusinessOrganizerActivityCounts(period='D7')?$format=application/json
Отклик
Ниже показан пример отклика.
Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 315
{
"value": [
{
"im": 20,
"audioVideo": 43,
"appSharing": 20,
"web": 6,
"dialInOut3rdParty": 0,
"dialInOutMicrosoft": 48,
"reportRefreshDate": "2017-09-01",
"reportDate": "2017-09-01",
"reportPeriod": "7"
}
]
}