Feedback Bearbeiten

Verwendete auflisten

  • Artikel
  • 6 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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

Für den angemeldeten Benutzer:

  • Diese Methode enthält Dokumente, die der Benutzer geändert hat. siehe Beispiel 1.
  • Mithilfe eines $orderby Abfrageparameters für die lastAccessedDateTime-Eigenschaft werden die zuletzt angezeigten Dokumente zurückgegeben, die der Benutzer möglicherweise geändert hat oder nicht; siehe Beispiel 2.

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

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

  • Hier erhalten Sie eine Liste der Dokumente, die der angemeldete Benutzer geändert hat:

    GET /me/insights/used

  • Hier erhalten Sie eine Liste der Dokumente, die der angegebene Benutzer geändert hat:

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

    Hinweis: Das Anfordern der verwendeten Dokumente eines anderen Benutzers gibt Ergebnisse nach lastModifiedDateTime sortiert zurück. lastAccessedDateTime wird dann auf lastModifiedDateTime festgelegt.

  • Erweitern Sie die Ressource, auf die durch einen verwendeten Einblick 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:

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

  • Wird $filter verwendet, 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, die Sie in resourceVisualization filtern können.

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

    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 zu erhalten, die von einem anderen Benutzer angezeigt oder geändert wurden. Siehe Beispiel 2.

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich.
Annehmen application/json

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

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

Wenn Elementeinblicke von Zielbenutzern deaktiviert wurden, gibt diese Methode den 403 Forbidden folgenden Fehler zurück:

{
  "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 vom Benutzer geändert wurden

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"
            }
        }
    ]
}