Erstellen oder Ersetzen eines activityHistoryItem-Objekts

Namespace: microsoft.graph

Erstellen Sie ein neues Oder ersetzen Sie ein vorhandenes Verlaufselement für eine vorhandene Benutzeraktivität.

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)	UserActivity.ReadWrite.CreatedByApp	Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto)	UserActivity.ReadWrite.CreatedByApp	Nicht verfügbar.
Anwendung	Nicht unterstützt	Nicht unterstützt

HTTP-Anforderung

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

{id} muss eine GUID sein.

Anforderungsheader

Name	Typ	Beschreibung
Authorization	string	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines activityHistoryItem-Objekts an.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode zurück, wenn das activityHistoryItem-Objekt erstellt wurde oder 200 OK wenn das activityHistoryItem ersetzt wurde.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

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

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const activityHistoryItem = {
    startedDateTime: '2015-02-11T20:54:04.3457274+00:00',
    userTimezone: 'Africa/Casablanca',
    lastActiveDateTime: '2015-02-11T20:54:04.3457274+00:00'
};

await client.api('/me/activities/{activity-id}/historyItems/{item-id}')
	.put(activityHistoryItem);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

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
}