Freigeben über

Verwendete auflisten

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Berechnen und auflisten der Dokumente, die ein Benutzer angezeigt oder geändert hat.

Für den angemeldeten Benutzer:

  • Diese Methode umfasst Dokumente, die der Benutzer geändert hat; Siehe Beispiel 1.
  • Die Verwendung eines Abfrageparameters $orderby für die lastAccessedDateTime-Eigenschaft gibt die zuletzt angezeigten Dokumente zurück, die der Benutzer möglicherweise geändert hat oder nicht. Siehe Beispiel 2.

Für andere Benutzer umfasst diese Methode nur Dokumente, die der Benutzer geändert hat.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Sites.Read.All Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

  • Rufen Sie eine Liste der Dokumente ab, die der angemeldete Benutzer geändert hat:

    GET /me/insights/used

  • Rufen Sie eine Liste der Dokumente ab, die der angegebene Benutzer geändert hat:

    GET /users/{id | userPrincipalName}/insights/used

    Hinweis: Wenn Sie die von einem anderen Benutzer verwendeten Dokumente anfordern, werden ergebnisse nach lastModifiedDateTime sortiert zurückgegeben. lastAccessedDateTime wird dann auf lastModifiedDateTime festgelegt.

  • Erweitern Sie die Ressource, auf die von einer verwendeten Erkenntnis verwiesen wird :

    GET /me/insights/used/{id}/resource
GET /users/{id | userPrincipalName}/insights/used/{id}/resource

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter , um die Antwort anzupassen:

  • Verwenden Sie den $filter Abfrageparameter, um verwendete Elemente zu filtern. Beispiel: Basierend auf dem Typ:

    https://graph.microsoft.com/beta/me/insights/used?$filter=ResourceVisualization/Type eq 'PowerPoint'

  • Verwenden Sie $filter , um verwendete Elemente basierend auf containerType zu filtern:

    https://graph.microsoft.com/beta/me/insights/used?$filter=ResourceVisualization/containerType eq 'OneDriveBusiness'

    Sehen Sie sich die verfügbaren Containertypen und -typen an, nach der Sie in resourceVisualization filtern können.

  • Verwenden Sie den $orderby Abfrageparameter, um Dokumente zu sortieren, die zuletzt vom angemeldeten Benutzer angezeigt oder geändert wurden, basierend auf der lastAccessedDateTime-Eigenschaft :

    https://graph.microsoft.com/beta/me/insights/used?$orderby=LastUsed/LastAccessedDateTime desc

    Hinweis: Verwenden Sie diese Abfrageoption nur für den angemeldeten Benutzer. Sie können diese API nicht verwenden, um Dokumente abzurufen, die von einem anderen Benutzer angezeigt oder geändert wurden. Siehe Beispiel 2.

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen application/json

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und eine Liste der verwendeten Elemente im Antworttext zurückgegeben.

Wenn Elementerkenntnisse des Zielbenutzers deaktiviert wurden, gibt diese Methode den folgenden Fehler zurück 403 Forbidden :

{
  "error": {
    "code": "ItemInsightsDisabled",
    "message": " The access to the requested resource is denied because item insights are disabled.",
    "innerError": {
      "requestId": "request-id",
      "date": "date-time"
    }
  }
}

Weitere Informationen finden Sie unter Anpassen des Datenschutzes für Einblicken.

Beispiel

Beispiel 1: Zurückgeben von Dokumenten, die der Benutzer geändert hat

Anforderung

GET https://graph.microsoft.com/beta/me/insights/used

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('c74dcd16-d8af-4df8-9621-d123b58de3e6')/insights/used",
    "value": [
        {
            "id": "Abk3ZeZmlghMhUVKP9mygDoPEPUbLediT7xb7UyGkIkmjsvR4JlgRUGA28jNM6INA5k5RvS1T4tPmZSWjFY1PFu5N2XmZpYITIVFSj_ZsoA6BQ",
            "lastUsed": {
                "lastAccessedDateTime": "2019-05-25T07:12:38Z",
                "lastModifiedDateTime": "2019-05-25T07:12:37Z"
            },
            "resourceVisualization": {
                "title": "Org Chart",
                "type": "Visio",
                "mediaType": "application/vnd.visio",
                "previewImageUrl": "https://contoso.sharepoint.com/_api/v2.0/drives/b!uTdl5maWCEyFRUo_2bKAOg8Q9Rst52JPvFvtTIaQiSaOy9HgmWBFQYDbyM0zog0D/items/01JSNPH6EZHFDPJNKPRNHZTFEWRRLDKPC3/thumbnails/0/small/thumbnailContent",
                "previewText": "Page-1",
                "containerWebUrl": "https://contoso.sharepoint.com/sites/Retail/Shared Documents/NC460 Sales",
                "containerDisplayName": "Retail",
                "containerType": "Site"
            },
            "resourceReference": {
                "webUrl": "https://contoso.sharepoint.com/sites/Retail/_layouts/15/Doc.aspx?sourcedoc=%7BF4463999-4FB5-4F8B-9994-968C56353C5B%7D&file=Org%20Chart.vsdx&action=default&DefaultItemOpen=1",
                "id": "drives/b!uTdl5maWCEyFRUo_2bKAOg8Q9Rst52JPvFvtTIaQiSaOy9HgmWBFQYDbyM0zog0D/items/01JSNPH6EZHFDPJNKPRNHZTFEWRRLDKPC3",
                "type": "microsoft.graph.driveItem"
            }
        }
    ]
}

Beispiel 2: Zurückgeben der zuletzt angezeigten Dokumente, die der angemeldete Benutzer möglicherweise geändert hat oder nicht

Anforderung

GET https://graph.microsoft.com/beta/me/insights/used?$orderby=LastUsed/LastAccessedDateTime desc

Antwort

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('c74dcd16-d8af-4df8-9621-d123b58de3e6')/insights/used",
    "value": [
        {
            "id": "AWTmrUBYzTxMsvtILkUktIaN-sDnMnRRTYqBxeih4bUUAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABk5q1AWM08TLL7SC5FJLSGBA",
            "lastUsed": {
                "lastAccessedDateTime": "2020-03-16T13:31:55Z",
                "lastModifiedDateTime": "0001-01-01T00:00:00Z"
            },
            "resourceVisualization": {
                "title": "Executive Corner",
                "type": "spsite",
                "mediaType": "application/octet-stream",
                "previewImageUrl": "https://contoso.sharepoint.com/_api/v2.0/drives/b!ZOatQFjNPEyy-0guRSS0ho36wOcydFFNioHF6KHhtRQAAAAAAAAAAAAAAAAAAAAA/items/01NTE4NPQAAAAAAAAAAAAAAAAAAAAAAAAA/thumbnails/0/small/thumbnailContent",
                "previewText": "",
                "containerDisplayName": "Executive Corner",
                "containerType": "Site"
            },
            "resourceReference": {
                "webUrl": "https://contoso.sharepoint.com/sites/Exec",
                "id": "sites/contoso.sharepoint.com,40ade664-cd58-4c3c-b2fb-482e4524b486,e7c0fa8d-7432-4d51-8a81-c5e8a1e1b514",
                "type": "microsoft.graph.siteItem"
            }
        }
    ]
}