Trends auflistenList trending

Namespace: Microsoft. GraphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Berechnete Einblicke, die eine Liste von Dokumenten enthält, die um den Benutzer herum tendieren.Calculated insight that includes a list of documents trending around the user.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Sites.Read.All, Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Sites.Read.All, Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

Abrufen einer Liste von Dokumenten, die sich um den angemeldeten Benutzer oder den angegebenen Benutzer herum bewegen:Get a list of documents trending around the signed-in user or specified user:

GET /me/insights/trending
GET /users/{id | userPrincipalName}/insights/trending

Erweitern Sie die Ressource, auf die durch eine Trend Einblicke verwiesen wird:Expand the resource referenced by a trending insight:

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

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData Query Parameters to help customize the response.

Sie können den $filter Abfrageparameter verwenden, um Trend Elemente zu filtern.You can use the $filter query parameter to filter trending items. Beispielsweise basierend auf dem Typ:For example, based on type:

https://graph.microsoft.com/v1.0/me/insights/trending?$filter=ResourceVisualization/type eq 'PowerPoint'

Oder basierend auf Container Type:Or based on containerType:

https://graph.microsoft.com/v1.0/me/insights/trending?$filter=ResourceVisualization/containerType eq 'OneDriveBusiness'

Siehe die verfügbaren Containertypen und-Typen, nach denen Sie in resourceVisualizationfiltern können.See the available container types and types you can filter by in resourceVisualization.

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
AnnehmenAccept application/jsonapplication/json

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200 OK werden der Antwortcode und eine Liste von Trend Elementen im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and a list of trending items in the response body. Jedes Element enthält Visualisierungs Eigenschaften zum Anzeigen des Elements in Ihrer Benutzeroberfläche.Each item contains visualization properties for displaying the item in your experience.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.Here is an example of the request.

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

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.Note: The response object shown here may be truncated for brevity. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.All of the properties will be returned from an actual call. Sehen Sie sich ein Beispiel ungekürzte Antwort am unteren Rand der Seite an.See an example un-truncated response at the bottom of the page.

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

{
    "value": [
        {
            "id": "id-value",
            "weight": "weight-value",
            "resourceVisualization": {
                "title": "title-value",
                "type": "type-value",
                "mediaType": "mediaType-value",
                "previewImageUrl": "previewImageUrl-value",
                "previewText": "previewText-value",
                "containerWebUrl": "containerWebUrl-value",
                "containerDisplayName": "containerDisplayName-value",
                "containerType": "containerType-value"
            },
            "resourceReference": {
                "webUrl": "webUrl-value",
                "id": "id-value",
                "type": "type-value"
            }
        }
    ]
}