Отчеты о CsAVConferenceTime *

  • Статья

Коды URI REST CsAVConferenceTime * предоставляют обобщенные сведения о время, затраченное на при входе пользователей в конференциях Lync Online Office 365, в которых использовался звука и видео. Существует три отчеты, которые отличаются только в интервал времени, через который они сведение данных и использовать же Общая структура: день, неделю и месяц. Для простоты в этой теме описаны три отчета.

Дата последнего изменения: 17 сентября 2015 г.

Область применения: Office 365

Коды URI REST

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeMonthly[?ODATA options]

Поля

В $select, $filter и $orderby параметры запроса ODATA2 можно указать следующие поля. Если указан параметр $select не возвращаются все поля.

Имя

WCF тип *

Тип EDM *

[В/Out] ** описание

Пример значения

Добавлено в версию обновления

AVConferenceMinutes

long

Edm.Int64

[In/Out] Количество минут, затраченное на конференции аудио/видео в отчетах периода времени, который заканчивается на значение даты.

3330

2013-V1

Date

System.DateTime

Edm.DateTime

[In/Out] Дата и время окончания отчетного периода. В следующих разделах Дополнительные сведения о отчетных периодов.

Краткий формат даты (например, 03/10/2013) или Дата и время в кавычки (например, "03/10/2013 4:55 PM")

2013-V1

ID

long

Edm.Int64

[In/Out] Номер индекса записи отчета.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] GUID организации.

16a58f78-539f-47f7-b9bf-02a63867d73b

2013-V1

TenantName

строка

Edm.String

[In/Out] Имя организации.

example.onmicrosoft.com

2013-V1

* Тип WCF относится к типу данных .NET Framework, назначенный в поле при создании ссылки на службу Windows Communications Framework (WCF) в Visual Studio. Имя относится к модели данных ADO.NET сущности (EDM) типов, которые возвращаются в формате Atom отчеты.

** [In/Out]: для получения дополнительных сведений см входные параметры и сообщить о раздел столбцы выходные данные.

Замечания

Для включения в переданные конференции ресурсов, использованных, по крайней мере один участник должен участвовали как своей учетной записи организации Office 365.

Участников конференции, у которых конференции с помощью мобильных устройств, например телефонов или планшетных компьютеров не включаются в счетчика времени. По этой причине, если всех участников конференции использование мобильных устройств, что конференции, не отображаются в отчете.

Конференции число возвращаемых включать только конференций, которые были организованы пользователей организации. Каждой конференции по категориям, независимо от количества пользователей или пользователей, которые участвуют учитывается только один раз. Так как различные планы Lync Online не могут содержать возможность организации конференций, но по-прежнему могут иметь возможность принимать участие в их, номер конференции, созданные в рамках этого клиента всегда легко может вернуть 0.

Каждый элемент в отчете о включает несколько полей метаданных. Для получения дополнительных сведений см Распространенные метаданных, возвращаемых веб-службой отчетов Office 365.

Три типа отчетов отличаются только за время, описывающую каждой записи отчета. Время, указанная в поле Дата представляет окончания периода времени. Сообщает значения даты и времени в часовом поясе, указанном в заголовке X-timezone получить HTTPS. Если часовой пояс не указан, то используется время в формате UTC. Продолжительность времени, обнаруженных рассчитывается следующим образом.

Имя отчета

Период времени вычисления

Ежедневно (CsAVConferenceTimeDaily)

Работы с отчетами день начинается точно полночь (00:00) и заканчивающейся только что до полуночи (23.59:59.9999) в тот же день. Последний день, обнаруженных будет последнего полного дня, для которого данные недоступны и не будут включены в текущий день. Дата и время возвращаются в поле Date представляет конца дня работы с отчетами.

Еженедельно (CsAVConferenceTimeWeekly)

Начала работы с отчетами недели в точно полночь (00:00) преждевременного в воскресенье и заканчивается перед полночь (23:59:59.9999) на следующих ночь суббота. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет конец данную неделю отчетов.

Ежемесячно (CsAVConferenceTimeMonthly)

Работы с отчетами месяца начинается точно полночь (00:00) на первый день месяца и заканчивается перед полночь (23.59:59.9999) в последний календарный день месяца. Недавно переданные запись — это один включает в себя текущего дня и таким образом обычно выходит за пределы при запросе отчета. Дата и время возвращаются в поле Date представляет окончание работы с отчетами месяца.

Примеры

Следующий запрос и ответ пары показано, как получить отчет об активности конференции аудио/видео по месяцам в формате JSON. Параметр запроса $select запрашивает только дата и время в минутах. Обратите внимание, был возвращен только один отчет точки данных, для 1-го мая 2013 г.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeMonthly?$select=Date,AVConferenceMinutes&$format=Json

  {
    "d":
      {
        "results":
          [            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeMonthly
                        (datetime'2013-05-01T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeMonthly
                        (datetime'2013-05-01T00%3A00%3A00')",
                    "type":"TenantReporting.CsAVConferenceTimeReport"
                  },
                "Date":"\/Date(1367366400000)\/",
                "AVConferenceMinutes":"37"
              }            
          ]        
      }    
  }

Следующий запрос и ответ пары показано, как получить ежедневное число минут конференции аудио/видео, используемые для 14 предыдущих дней, в обратном порядке порядке. Как предыдущего запроса эта команда только Date и AVConferenceMinutes число запросов и запрашивает сведения в формате Atom. Отчет возвращает запись для каждого дня, который содержит данные, поэтому в данном случае $top ограничение применяется к последнему 14 "дней с данными", который не обязательно совпадает с последнего 14 календарных дней. Чтобы ограничить отчетного периода определенное время, используйте параметр $filter запроса. Помните, которые были добавлены символы перевода строки запроса и ответа для наглядности.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeDaily?
  $select=Date,TenantName,AVConferenceMinutes&
  $filter=Date%20ge%20datetime'2013-01-01T00:00:00'%20and%20
    Date%20lt%20datetime'2013-06-26T00:00:00'&
  $orderby=Date%20desc&
  $format=Atom

<?xml version="1.0" encoding="utf-8"?>
<feed 
    xml:base="https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/" 
    xmlns="http://www.w3.org/2005/Atom" 
    xmlns:d="https://schemas.microsoft.com/ado/2007/08/dataservices" 
    xmlns:m="https://schemas.microsoft.com/ado/2007/08/dataservices/metadata">
  <id>https://reports.office365.com/ecp/reportingwebservice/reporting.svc/CsAVConferenceTimeDaily</id>
  <title type="text">CsAVConferenceTimeDaily</title>
  <updated>2013-07-08T23:41:28Z</updated>
  <link rel="self" title="CsAVConferenceTimeDaily" href="CsAVConferenceTimeDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-14T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-14T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">13</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-13T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-13T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">24</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-10T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-10T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">93</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/CsAVConferenceTimeDaily
        (datetime'2013-05-05T00%3A00%3A00')</id>
    <category term="TenantReporting.CsAVConferenceTimeReport" 
        scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <title />
    <updated>2013-07-08T23:41:28Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:Date m:type="Edm.DateTime">2013-05-05T00:00:00</d:Date>
        <d:AVConferenceMinutes m:type="Edm.Int64">165</d:AVConferenceMinutes>
      </m:properties>
    </content>
  </entry>
</feed>

Входные параметры и сообщить о выходных столбцов

[In/Out] индикаторов в таблице полей имеют следующие значения:

  • Поля, отмеченные [In] в поля в таблице в основном предназначены для использования в $filter=, $orderby= и другие параметры запроса, ограничивающие вводимых данных в отчете. Поля, отмеченные [In] в поля в таблице может быть включен параметр $select= и они будут отображаться в отчет операции, но они будут не содержат полезных данных.

  • Поля, отмеченные [In/Out] в поля, которые в таблице можно использовать в выделенный фрагмент столбца ($select=) и параметры ($filter= и $orderby=) ограничение записей. При включении одно из этих полей в параметре $select= , они будут отображаться в отчет операции и будет содержать полезные данные, если она доступна.

Совместимость

Отчеты о CsAVConferenceTimeDaily, CsAVConferenceTimeWeekly и CsAVConferenceTimeMonthly были представлены в Служба Office 365 версии 2013-V1. Дополнительные сведения об управлении версиями можно Управление версиями в веб-службе отчетов Office 365.

Соответствующий командлеты PowerShell

Отчеты о CsAVConferenceTime * возвращать те же данные в командлет Get-CsAVConferenceTimeReportWindows PowerShell. 

Разрешения

Учетная запись для доступа к отчетов из требуются права администратора в организации, Office 365. При наличии в документ описания службы и возвращается пользователю $metadata документа отчета они имеют разрешения для извлечения данных из веб-службы REST. В этом отчете требует от пользователя быть назначена роль получателей только для просмотра. В структуре разрешения по умолчанию Office 365 пользователей со следующими разрешениями администратора может вызвать этот отчет: выставления счетов администратора, глобального администратора, пароль администратора, администратора служб и администратор управления пользователями.

Степень детализации данных, сохранение состояния и доступности

Информация, доступная через этих отчетов можно разделить на один день периодов, начиная с полуночи часовой пояс, вызывающему приложению в заголовке HTTP X-timezone .

Сведения для этого отчета можно найти в течение одного года или до отмены подписки.

События с задержкой в течение 24 часов, прежде чем они отображаются в отчете.