Lecteur : récent (déconseillé)

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Attention

L’API récente est déconseillée et fonctionnera dans un état dégradé jusqu’en novembre 2026, après quoi elle cessera de renvoyer des données.

Répertorier un ensemble d’éléments récemment utilisés par l’utilisateur connecté. Cette collection inclut les éléments qui se trouvent dans le lecteur de l’utilisateur et ceux auxquels il a accès à partir d’autres lecteurs.

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global Gouvernement américain L4 Gouvernement américain L5 (DOD) Chine exploitée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation Autorisations les moins privilégiées Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire) Files.Read Files. Read.All, Files. ReadWrite, Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read Files. Read.All, Files. ReadWrite, Files. ReadWrite.All
Application Non prise en charge. Non prise en charge.

Requête HTTP

GET /me/drive/recent

Réponse

Cette méthode renvoie une collection de ressources DriveItem pour les éléments auxquels le propriétaire du lecteur a récemment accédé.

Exemples

Demande

L’exemple suivant illustre une demande.

GET /me/drive/recent

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "1312abc!1231",
      "remoteItem":
      {
        "id": "1991210caf!192",
        "name": "March Proposal.docx",
        "file": { },
        "size": 19121,
        "parentReference": {
          "driveId": "1991210caf",
          "id": "1991210caf!104"
        }
      },
      "fileSystemInfo": {
        "lastAccessedDateTime": "2017-02-20T19:13:00Z"
      }
    },
    {
      "id": "1312def!9943",
      "name": "Vacation.jpg",
      "file": { },
      "size": 37810,
      "parentReference": {
        "driveId": "1312def",
        "id": "1312def!123"
      },
      "fileSystemInfo": {
        "lastAccessedDateTime": "2017-02-20T16:43:21Z"
      }
    }
  ]
}

Remarques

Certains driveItems retournés à partir de l’action récente incluent la facette remoteItem qui indique que les éléments proviennent d’un autre lecteur. Pour accéder à l’objet driveItem d’origine, vous devez effectuer une requête, en utilisant les informations fournies dans remoteItem au format suivant :

GET /drives/{remoteItem-driveId}/items/{remoteItem-id}