最近のユーザー アクティビティを取得する
名前空間: microsoft.graph
特定のユーザーの最近のアクティビティを取得します。 この OData 関数には、"最近使用された" API のように動作させるために、いくつかの既定の動作が含まれています。 サービスは、最新の アクティビティHistoryItems に対してクエリを実行し、それらの関連アクティビティをプルします。 アクティビティは、activityHistoryItem の最新の lastModified に従って並べ替えられます。 つまり、 activityHistoryItems を持たないアクティビティは応答に含まれません。 UserActivity.ReadWrite.CreatedByApp アクセス許可も応答に追加のフィルター処理を適用するため、アプリケーションによって作成されたアクティビティのみが返されます。 ユーザーがアクティブであり、他のアプリケーションが新しいアクティビティを作成した場合、このサーバー側のフィルター処理によって空のページが作成される可能性があります。 アプリケーションのアクティビティを取得するには、 nextLink プロパティを使用してページ分割します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | UserActivity.ReadWrite.CreatedByApp | 注意事項なし。 |
| 委任 (個人用 Microsoft アカウント) | UserActivity.ReadWrite.CreatedByApp | 注意事項なし。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
HTTP 要求
GET /me/activities/recent
オプションのクエリ パラメーター
このメソッドでは、応答のカスタマイズに役立つ OData クエリ パラメーター がいくつかサポートされています。 次のクエリ パラメーターがサポートされています。
- historyItems ナビゲーション プロパティの$expand。
- ページ間のアイテムの最大数を制限する$top。
- 展開されている場合は、アクティビティまたは activityHistoryItems の lastModifiedDateTime プロパティに$filterします。
URL エンコードを使用してサポートされるクエリの例を次に示します。
/me/activities/recent?$expand=historyItems($filter=lastModifiedDateTime%20gt%202018-01-22T21:45:00.347Z%20and%20lastModifiedDateTime%20lt%202018-01-22T22:00:00.347Z)
/me/activities/recent?$filter=lastModifiedDateTime%20lt%202018-01-16T01:03:21.347Z%20and%20lastModifiedDateTime%20gt%202018-01-03T01:03:21.347Z
/me/activities/recent?$top=5
要求ヘッダー
| 名前 | 種類 | 説明 |
|---|---|---|
| Authorization | string | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
要求本文を指定しないでください。
応答
成功した場合、このメソッドは、アプリケーションのユーザーの最近のアクティビティを含む 200 OK 応答コードを返します。
例
要求
要求の例を次に示します。
GET https://graph.microsoft.com/v1.0/me/activities/recent
応答
応答の例を下に示します。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(userActivity)",
"@odata.nextLink":"https://graph.microsoft.com/v1.0/me/activities/recent?$skiptoken=%24filter%3dlastModifiedDateTime+lt+2018-02-26T18%3a06%3a19.365Z",
"value":[
{
"@odata.type":"#microsoft.graph.userActivity",
"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"
}
]
}