Aktualisiert oder fügt eine bestimmte Sitzung ein. Jetzt testen
Anfrage
HTTP-Anfrage
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
Parameter
Parametername | Wert | Beschreibung |
---|---|---|
Pfadparameter | ||
sessionId |
string |
Die ID der zu erstellenden Sitzung. |
userId |
string |
Erstellen Sie Sitzungen für die identifizierte Person. Mit me geben Sie
mit dem authentifizierten Nutzer. Derzeit wird nur me unterstützt.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:
Umfang |
---|
https://www.googleapis.com/auth/fitness.activity.write |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext Daten mit der folgenden Struktur ein:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
id |
string |
Eine vom Client generierte Kennung, die für alle Sitzungen dieses Nutzers eindeutig ist. | |
name |
string |
Ein für Menschen lesbarer Name der Sitzung. | |
description |
string |
Eine Beschreibung dieser Sitzung. | |
startTimeMillis |
long |
Eine Startzeit in Millisekunden seit einschließlich Epoche. | |
endTimeMillis |
long |
Eine Endzeit in Millisekunden seit Epoche (einschließlich). | |
modifiedTimeMillis |
long |
Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde. | |
application |
nested object |
Die Anwendung, die die Sitzung erstellt hat. | |
application.packageName |
string |
Paketname für diese Anwendung. Sie wird als eindeutige Kennung verwendet, wenn sie von Android-Anwendungen erstellt wird, kann aber nicht von REST-Clients angegeben werden. Bei REST-Clients wird die Nummer des Entwicklerprojekts in den IDs des Datenstreams der Datenquelle anstatt im packageName angegeben. | |
application.version |
string |
Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung so ändert, dass sich dies auf die Berechnung der Daten auswirkt. | |
application.detailsUrl |
string |
Ein optionaler URI, mit dem eine Verknüpfung zurück zur Anwendung hergestellt werden kann. | |
application.name |
string |
Der Name dieser Anwendung. Dies ist für REST-Clients erforderlich, die Eindeutigkeit dieses Namens wird jedoch nicht erzwungen. Sie ist für andere Entwickler gedacht, die wissen möchten, mit welcher REST eine Anwendung oder Datenquelle erstellt wurde. | |
activityType |
integer |
Der Aktivitätstyp dieser Sitzung. | |
activeTimeMillis |
long |
Aktive Zeit der Sitzung. Während start_time_millis und end_time_millis die vollständige Sitzungsdauer definieren, kann die aktive Zeit auch kürzer sein und durch „active_time_millis“ angegeben werden. Wenn die Zeit der Inaktivität während der Sitzung bekannt ist, sollte sie auch über einen com.google.activity.segment-Datenpunkt mit dem Aktivitätswert STILL eingefügt werden |
Antwort
Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
Name der Eigenschaft | Wert | Beschreibung | Hinweise |
---|---|---|---|
id |
string |
Eine vom Client generierte Kennung, die für alle Sitzungen dieses Nutzers eindeutig ist. | |
name |
string |
Ein für Menschen lesbarer Name der Sitzung. | |
description |
string |
Eine Beschreibung dieser Sitzung. | |
startTimeMillis |
long |
Eine Startzeit in Millisekunden seit einschließlich Epoche. | |
endTimeMillis |
long |
Eine Endzeit in Millisekunden seit Epoche (einschließlich). | |
modifiedTimeMillis |
long |
Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde. | |
application |
nested object |
Die Anwendung, die die Sitzung erstellt hat. | |
application.packageName |
string |
Paketname für diese Anwendung. Sie wird als eindeutige Kennung verwendet, wenn sie von Android-Anwendungen erstellt wird, kann aber nicht von REST-Clients angegeben werden. Bei REST-Clients wird die Nummer des Entwicklerprojekts in den IDs des Datenstreams der Datenquelle anstatt im packageName angegeben. | |
application.version |
string |
Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung so ändert, dass sich dies auf die Berechnung der Daten auswirkt. | |
application.detailsUrl |
string |
Ein optionaler URI, mit dem eine Verknüpfung zurück zur Anwendung hergestellt werden kann. | |
application.name |
string |
Der Name dieser Anwendung. Dies ist für REST-Clients erforderlich, die Eindeutigkeit dieses Namens wird jedoch nicht erzwungen. Sie ist für andere Entwickler gedacht, die wissen möchten, mit welcher REST eine Anwendung oder Datenquelle erstellt wurde. | |
activityType |
integer |
Der Aktivitätstyp dieser Sitzung. | |
activeTimeMillis |
long |
Aktive Zeit der Sitzung. Während start_time_millis und end_time_millis die vollständige Sitzungsdauer definieren, kann die aktive Zeit auch kürzer sein und durch „active_time_millis“ angegeben werden. Wenn die Zeit der Inaktivität während der Sitzung bekannt ist, sollte sie auch über einen com.google.activity.segment-Datenpunkt mit dem Aktivitätswert STILL eingefügt werden |
Testen!
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.