項目アクティビティの統計を間隔で取得する
名前空間: microsoft.graph
指定した期間内にこのリソース上で行われたアクティビティの itemActivityStats リソースのコレクションを取得します。
注:itemAnalytics リソースは、まだすべての国内展開で使用できるわけではありません。
分析集計は、一部のアクション タイプでは使用できない場合があります。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。
アクセス許可の種類 | 最小特権アクセス許可 | 特権の高いアクセス許可 |
---|---|---|
委任 (職場または学校のアカウント) | Files.Read | Files.ReadWrite、Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
アプリケーション | Files.Read.All | Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
HTTP 要求
GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
GET /sites/{site-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
GET /sites/{site-id}/lists/{list-id}/items/{item-id}/getActivitiesByInterval(startDateTime={startDateTime},endDateTime={endDateTime},interval={interval})
関数パラメーター
パラメーター | 型 | 説明 |
---|---|---|
startDateTime | 文字列 (タイムスタンプ) | アクティビティを集計する開始時間。 |
endDateTime | 文字列 (タイムスタンプ) | アクティビティを集計する終了時間。 |
interval | string | 集計間隔。 |
注: この API では、日次カウントの 90 日間の時間範囲のみをサポートしています。
startDateTime
パラメーターとendDateTime
パラメーターの値は、90 日未満の時間範囲である必要があります。
オプションのクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリ パラメーターをサポートします。
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {code}。 必須です。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドでは 200 OK
応答コードと、応答本文で itemActivityStats オブジェクトのコレクションを返します。
例
要求
GET /drives/{drive-id}/items/{item-id}/getActivitiesByInterval(startDateTime='2017-01-01',endDateTime='2017-01-3',interval='day')
応答
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"startDateTime": "2017-01-01T00:00:00.000Z",
"endDateTime": "2017-01-02T00:00:00.000Z",
"delete": {
"actionCount": 1,
"actorCount": 1
},
"access": {
"actionCount": 5,
"actorCount": 3
}
},
{
"startDateTime": "2017-01-02T00:00:00.000Z",
"endDateTime": "2017-01-03T00:00:00.000Z",
"edit": {
"actionCount": 3,
"actorCount": 1
},
"access": {
"actionCount": 7,
"actorCount": 6
}
}
]
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示