最近のユーザー アクティビティを取得する

  • [アーティクル]

名前空間: microsoft.graph

特定のユーザーの最近のアクティビティを取得します。 この OData 関数には、"最近使用された" API のように動作させるために、いくつかの既定の動作が含まれています。 サービスは、最新の historyItems に対してクエリを実行し、関連するアクティビティをプルします。 アクティビティは、historyItem の最新の lastModified に従って並べ替えられます。 つまり、 historyItems のないアクティビティは応答に含まれません。 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。
  • 展開されている場合は、アクティビティまたは historyItems の 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"
      }
   ]
}