ユーザーアクティビティを取得する
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
特定のユーザーのアクティビティを取得します。 最近の OData 関数とは異なり、履歴のないアクティビティは返されます。 アクセス許可 UserActivity は、アプリケーションによって作成されたアクティビティのみが返されるように、応答に特別なフィルター処理を適用します。 このサーバー側のフィルタリングは、ユーザーが特にアクティブで、その他のアプリケーションがより新しいアクティビティを作成した場合に、空のページになる可能性があります。 アプリケーションのアクティビティを取得するには、 Nextlink プロパティを使用して改ページにします。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | UserActivity.ReadWrite.CreatedByApp |
| 委任 (個人用 Microsoft アカウント) | UserActivity.ReadWrite.CreatedByApp |
| アプリケーション | サポートされていません。 |
HTTP 要求
GET /me/activities
省略可能なクエリ パラメーター
このメソッドは、応答をカスタマイズするための OData クエリパラメーター をサポートします。 次のクエリパラメーターがサポートされています。
- 履歴項目ナビゲーションプロパティの $expand。
- ページ間でのアイテムの最大数を制限する $top。
- lastModifiedDateTimeプロパティを使用して、アクティビティまたは履歴アイテム(展開されている場合) のどちらかを $filter します。
次に、URL エンコードを使用してサポートされているクエリの例をいくつか示します。
/me/activities?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z)
/me/activities?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z
/me/activities?$top=5
要求ヘッダー
| 名前 | 型 | 説明 |
|---|---|---|
| Authorization | string | ベアラー {トークン}。必須。 |
要求本文
要求本文がありません。
応答
成功した場合、このメソッドは 200 OK アプリケーションに対するユーザーのアクティビティと共に応答コードを返します。
例
要求
要求の例を次に示します。
GET https://graph.microsoft.com/beta/me/activities
応答
応答の例を次に示します。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#Collection(userActivity)",
"@odata.nextLink": "https://graph.microsoft.com/beta/me/activities?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
"value": [{
"@odata.type": "#microsoft.graph.activity",
"activitySourceHost": "https://www.contoso.com",
"createdDateTime": "2018-02-26T18:34:29.592Z",
"lastModifiedDateTime": "2018-02-26T18:34:29.607Z",
"id": "5347642601316252694",
"appActivityId": "/article?12345",
"visualElements": {
"attribution": {
"iconUrl": "https://www.contoso.com/icon",
"alternateText": "Contoso, Ltd.",
"addImageQuery": "false",
},
"displayText": "Contoso How-To: How to Tie a Reef Knot",
"description": "How to Tie a Reef Knot. A step-by-step visual guide to the art of nautical knot-tying.",
"backgroundColor": "#ff0000",
"content": {
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
"type": "AdaptiveCard",
"body":
[{
"type": "TextBlock",
"text": "Contoso MainPage"
}]
}
},
"activationUrl": "https://www.contoso.com/article?id=12345",
"appDisplayName": "Contoso, Ltd.",
"userTimezone": "Africa/Casablanca",
"fallbackUrl": "https://www.contoso.com/article?id=12345",
"contentUrl": "https://www.contoso.com/article?id=12345",
"contentInfo": {
"@context": "https://schema.org",
"@type": "Article",
"author": "John Doe",
"name": "How to Tie a Reef Knot"
},
"expirationDateTime": "2018-03-28T18:34:29.607Z",
"status": "updated"
}]
}
フィードバック
フィードバックの送信と表示