Erstellen oder Ersetzen eines historyItemCreate or replace a historyItem

Namespace: Microsoft. GraphNamespace: microsoft.graph

Erstellen Sie ein neues oder ersetzen Sie ein vorhandenes Verlaufselement für eine vorhandene Benutzeraktivität.Create a new or replace an existing history item for an existing user activity.

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) UserActivity.ReadWrite.CreatedByAppUserActivity.ReadWrite.CreatedByApp
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) UserActivity.ReadWrite.CreatedByAppUserActivity.ReadWrite.CreatedByApp
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

PUT /me/activities/{id}/historyItems/{id}

ID muss eine GUID sein.Id needs to be a GUID.

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung eines historyItem -Objekts an.In the request body, supply a JSON representation of a historyItem object.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 201 Created wird der Antwortcode zurückgegeben, wenn 200 OK die historyItem erstellt wurde oder wenn die historyItem ersetzt wurde.If successful, this method returns the 201 Created response code if the historyItem was created or 200 OK if the historyItem was replaced.

BeispielExample

AnforderungRequest

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

PUT https://graph.microsoft.com/v1.0/me/activities/{activity-id}/historyItems/{item-id}
Content-type: application/json
Content-length: 364

{
    "startedDateTime": "2015-02-11T20:54:04.3457274+00:00",
    "userTimezone": "Africa/Casablanca",
    "lastActiveDateTime": "2015-02-11T20:54:04.3457274+00:00"
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.Here is an example of the response.

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

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('user%40contoso.com')/activities('13881113971988980728')/historyItems/$entity",
    "status": "updated",
    "userTimezone": "Africa/Casablanca",
    "createdDateTime": "2018-02-26T20:28:22.14Z",
    "lastModifiedDateTime": "2018-02-26T20:28:22.155Z",
    "id": "9d0b74e4-4b41-43ea-b34d-f9c1bf9f809c",
    "startedDateTime": "2018-02-26T20:54:04.345Z",
    "lastActiveDateTime": "2018-02-26T20:54:24.345Z",
    "expirationDateTime": "2018-03-28T20:28:22.14Z",
    "activeDurationSeconds": 20
}