GroupActivity * Berichte

  • Artikel

Die REST-URIs GroupActivity * enthalten zusammenfassende Statistiken zu den Office 365 Organisation Gruppe erstellen und löschen. Es stehen vier Berichte, die die gleiche Gesamtstruktur verwenden und unterscheiden sich nur in das Zeitintervall, in dem sie die Daten zusammenfassen: täglichen, wöchentlichen, monatlichen und jährlichen. Zur Vereinfachung sind die vier Berichte in diesem Thema eine detaillierte.

Letzte Änderung: Donnerstag, 17. September 2015

Gilt für: Office 365

REST-URIs

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityDaily[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityWeekly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityMonthly[?ODATA options]
https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityYearly[?ODATA options]

Felder

Die folgenden Felder können in den ODATA2-Abfrageoptionen $select, $filter und $orderby angegeben werden. Alle Felder werden zurückgegeben, wenn keine $select-Option angegeben wird.

Name

WCF-Typ*

EDM-Typ*

[In/Out]** Beschreibung

Beispielwerte

Hinzugefügt in Dienstversion

Date

System.DateTime

Edm.DateTime

[In/Out] Das Enddatum und die Uhrzeit des Berichtszeitraums. Finden Sie weitere Informationen zu Zeiträume für Zeitberichte in den folgenden Abschnitten.

Kurzes Datum (z. B. 03/10/2013) oder Datum und Uhrzeit mit Anführungszeichen (z. B. "03/10/2013 4:55 PM")

2013-V1

GroupCreated

long

Edm.Int64

[In/Out] Die Anzahl der Office 365 organisatorische Gruppen, die während der angegebenen Periode erstellt.

265

2013-V1

GroupDeleted

long

Edm.Int64

[In/Out] Die Anzahl der Office 365 organisatorische Gruppen diesen Zeitraum gelöscht.

72

2013-V1

TenantGuid

System.guid

Edm.Guid

[In/Out] Die GUID der Organisation.

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

2013-V1

TenantName

string

Keine Angabe

[In/Out] Der Name der primären Domäne der Organisation.

example.onmicrosoft.com

2013-V1

* WCF-Typ bezieht sich auf den .NET Framework-Datentyp in das Feld zugewiesen wird, wenn Sie einen Dienstverweis Windows Communications Framework (WCF) in Visual Studio erstellen. Den EDM-Typ bezieht sich auf die ADO.NET Entity Data Model (EDM)-Typen, die in Berichten Atom-Format zurückgegeben.

** [In/Out]: finden Sie unter der Eingabeparameter und Ausgabe Spalten Bereich eines Berichts.

Hinweise

Jeder Eintrag im Bericht enthält mehrere Metadatenfelder. Weitere Informationen finden Sie unter Gemeinsame Metadaten, die von der Office 365-Berichterstattungswebdienst zurückgegeben.

Die vier Berichtstypen unterscheiden sich nur in Höhe von Zeit, die jeder Eintrag im Bericht werden behandelt. Die Zeit im Feld Datum darstellt, das Ende des Zeitraums. Datums- und Zeitangaben werden in der Zeitzone angegeben, in der Kopfzeile für HTTPS GET X-timezone gemeldet. Wenn keine Zeitzone angegeben ist, wird die UTC-Zeit verwendet. Die Zeitdauern gemeldet werden wie folgt berechnet:

Berichtname

Zeitraum Berechnung

Tägliche (GroupActivityDaily)

Der reporting Tag beginnt um genau Mitternacht (00: 00:00) und kurz vor Mitternacht (23.59:59.9999...) für denselben Tag endet. Der letzte Tag gemeldet werden die letzten vollständigen Tag für die Daten verfügbar ist, und nicht den aktuellen Tag einschließen. Stellt am Ende dieses Tages reporting, Datum und Uhrzeit im Feld Date zurückgegeben.

Wöchentlich (GroupActivityWeekly)

Die reporting Woche beginnt um genau Mitternacht (00: 00:00), Samstag, frühen und kurz vor Mitternacht (23:59:59.9999...) in der folgenden Freitag Nacht endet. Der Eintrag zuletzt gemeldete ist eine, die den aktuellen Tag und aus diesem Grund wird in der Regel hinausgehen, wenn der Bericht angefordert wird. Datum und Uhrzeit im Feld Date zurückgegeben stellt am Ende dieser reporting Woche.

Monatlich (GroupActivityMonthly)

Reporting Monats beginnt um genau Mitternacht (00: 00:00) am ersten Tag des Monats und enden kurz vor Mitternacht (23.59:59.9999...) am letzten Kalendertag des Monats. Der Eintrag zuletzt gemeldete ist eine, die den aktuellen Tag und aus diesem Grund wird in der Regel hinausgehen, wenn der Bericht angefordert wird. Datum und Uhrzeit im Feld Date zurückgegeben stellt Ende des reporting Monats dar.

Jährliche (GroupActivityYearly)

Das Jahr beginnt um genau Mitternacht (00: 00:00) am 1. Januar des diese Kalenderjahr sowie die Enden kurz vor Mitternacht (23.59:59.9999...) am 31. Dezember, demselben Kalenderjahr. Der Eintrag zuletzt gemeldete ist eine, die den aktuellen Tag und aus diesem Grund wird in der Regel hinausgehen, wenn der Bericht angefordert wird. Datum und Uhrzeit im Feld Date zurückgegeben stellt Ende des reporting Monats dar.

Beispiele

Das folgende Anforderung und Antwort-Paar wird gezeigt, wie einen Bericht zu Aktivitäten nach Monat im JSON-Format abrufen.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityMonthly?$format=Json

  {
    "d":
      {
        "results":
          [
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2012-11-30T00%3A00%3A00')",
                    "type":"TenantReporting.GroupActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1354233600000)\/",
                "GroupCreated":"0",
                "GroupDeleted":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2012-12-31T00%3A00%3A00')",
                    "type":"TenantReporting.GroupActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1356912000000)\/",
                "GroupCreated":"0",
                "GroupDeleted":"0"
              },
            
              {
                "__metadata":
                  {
                    "id":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
                    "uri":"https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityMonthly(datetime'2013-01-31T00%3A00%3A00')",
                    "type":"TenantReporting.GroupActivityReport"
                  },
                "TenantGuid":"16a58f78-5e9f-47f7-bebf-02ae3867d73b",
                "TenantName":"example.onmicrosoft.com",
                "Date":"\/Date(1359590400000)\/",
                "GroupCreated":"0",
                "GroupDeleted":"0"
              }
            
          ]
        
      }
    
  }

Das folgende Anforderung und Antwort-Paar wird gezeigt, wie die tägliche Anzahl Gruppen erstellt, für die letzten vier Tage in umgekehrter Reihenfolge abzurufen. Diese Abfrage fordert nur die Anzahl der GroupCreated und fordert die Informationen im Atom-Format dar. Die Anforderung und Antwort aus Gründen der Übersichtlichkeit wurden Zeilenumbrüche hinzugefügt.

https://reports.office365.com/ecp/reportingwebservice/reporting.svc/GroupActivityDaily?
  $select=GroupCreated&
  $top=4&
  $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/GroupActivityDaily</id>
  <title type="text">GroupActivityDaily</title>
  <updated>2013-01-31T04:38:37Z</updated>
  <link rel="self" title="GroupActivityDaily" href="GroupActivityDaily" />
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityDaily(datetime'2013-01-29T00%3A00%3A00')</id>
    <category term="TenantReporting.GroupActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="GroupActivityReport" href="GroupActivityDaily(datetime'2013-01-29T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T04:38:37Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:GroupCreated m:type="Edm.Int64">0</d:GroupCreated>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityDaily(datetime'2013-01-28T00%3A00%3A00')</id>
    <category term="TenantReporting.GroupActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="GroupActivityReport" href="GroupActivityDaily(datetime'2013-01-28T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T04:38:37Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:GroupCreated m:type="Edm.Int64">0</d:GroupCreated>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityDaily(datetime'2013-01-27T00%3A00%3A00')</id>
    <category term="TenantReporting.GroupActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="GroupActivityReport" href="GroupActivityDaily(datetime'2013-01-27T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T04:38:37Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:GroupCreated m:type="Edm.Int64">0</d:GroupCreated>
      </m:properties>
    </content>
  </entry>
  <entry>
    <id>https://reports.office365.com/ecp/ReportingWebService/Reporting.svc/GroupActivityDaily(datetime'2013-01-26T00%3A00%3A00')</id>
    <category term="TenantReporting.GroupActivityReport" scheme="https://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <link rel="edit" title="GroupActivityReport" href="GroupActivityDaily(datetime'2013-01-26T00%3A00%3A00')" />
    <title />
    <updated>2013-01-31T04:38:37Z</updated>
    <author>
      <name />
    </author>
    <content type="application/xml">
      <m:properties>
        <d:GroupCreated m:type="Edm.Int64">0</d:GroupCreated>
      </m:properties>
    </content>
  </entry>
</feed>

Eingabeparameter und Berichtsausgabespalten

Die [In/Out]-Indikatoren in der Feldertabelle haben folgende Bedeutung:

  • Felder, die in den Feldern der Tabelle werden in erster Linie für die Verwendung in $filter=, $orderby= und andere Abfrageoptionen, die die Einträge des Berichts einschränken [In] gekennzeichnet werden. Felder [In] die Tabelle kann Felder enthalten die Option $select= und wird angezeigt, in dem Berichtseinträge, aber sie werden keine sinnvollen Daten enthalten.

  • [In/Out] Felder in den Feldern, die in der Spalte ($select=) und Einschränkung ($filter= und $orderby=) Optionen Tabelle verwendet werden kann. Wenn Sie eines der Felder in der Option $select= einschließen, sie werden in die Berichtseinträge im angezeigt und enthält nützliche Daten aus, wenn es zur Verfügung steht.

Kompatibilität

Die Berichte GroupActivityDaily, GroupActivityWeekly, GroupActivityMonthly und GroupActivityYearly wurden in Office 365-Dienstversion 2013-V1 eingeführt. Weitere Informationen zu versionsverwaltung finden Sie unter Versionsverwaltung in den Webdienst Office 365 Reporting.

Entsprechende PowerShell-cmdlets

Die GroupActivity * Berichte liefern die gleiche Informationen wie das Cmdlet Get-GroupActivityReportWindows PowerShell. 

Berechtigungen

Das Konto, das Sie Zugriff auf die Berichte aus benötigen in dieser Organisation Office 365 Administratorberechtigungen. Wenn das Konto in diesem Bericht in der Systemsteuerung Office 365 anzeigen kann, verfügt das Konto über Berechtigungen zum Abrufen der Daten aus dem REST-Webdienst. In diesem Bericht bewirkt, dass den Benutzer, die Rolle des Kontaktobjekts Empfänger zugewiesen werden soll. In der Standardeinstellung Office 365 Berechtigungsstruktur, können Benutzer mit der folgenden Administratorberechtigungen öffnen dieses Berichts: Abrechnung Administrator, globaler Administrator, Kennwort-Administrator, Dienstadministrator und Benutzerverwaltungsadministrator.

Granularität, Dauerhaftigkeit und Verfügbarkeit von Daten

Informationen über diese Berichte kann in einem Tag Zeiträume, getrennt werden, beginnend um Mitternacht der Zeitzone, die von der aufrufenden Anwendung im HTTP-Header X-timezone gemeldet.

Die Informationen für diesen Bericht steht für einen Zeitraum von einem Jahr oder bis das Abonnement abgebrochen wird.

Ereignisse können bis zu 24 Stunden verzögert sein, bevor sie in einem Bericht angezeigt werden.