Users.sessions: update

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. Verwenden Sie me, um den authentifizierten Nutzer anzugeben. Derzeit wird nur me unterstützt.

Autorisierung

Für diese Anfrage ist eine Autorisierung in 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
}
Attributname 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 für diese Sitzung.
startTimeMillis long Eine Startzeit in Millisekunden seit Beginn der Epoche.
endTimeMillis long Eine Endzeit in Millisekunden seit Epoche.
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-Apps erstellt wird. Sie kann jedoch nicht von REST-Clients angegeben werden. Die Nummer des Entwicklerprojekts wird anstelle der packageName in den Datenquellen-IDs der Datenquellen angegeben.
application.version string Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung so ändert, dass die Berechnung der Daten beeinträchtigt wird.
application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung 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 nur für Nutzer gedacht, die wissen möchten, über welche REST-Anwendung eine Anwendung oder Datenquelle erstellt wurde.
activityType integer Die Art der Aktivität, die diese Sitzung darstellt.
activeTimeMillis long Sitzungsdauer in Sitzung. Während „start_time_millis“ und „end_time_millis“ die volle Sitzungsdauer definieren, kann die aktive Zeit kürzer sein und durch „active_time_millis“ angegeben werden. Wenn die Inaktivitätszeit während der Sitzung bekannt ist, sollte sie auch über einen com.google.activity.segment-Datenpunkt mit einem STILL-Aktivitätswert

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 für diese Sitzung.
startTimeMillis long Eine Startzeit in Millisekunden seit Beginn der Epoche.
endTimeMillis long Eine Endzeit in Millisekunden seit Epoche.
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-Apps erstellt wird. Sie kann jedoch nicht von REST-Clients angegeben werden. Die Nummer des Entwicklerprojekts wird anstelle der packageName in den Datenquellen-IDs der Datenquellen angegeben.
application.version string Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung so ändert, dass die Berechnung der Daten beeinträchtigt wird.
application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung 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 nur für Nutzer gedacht, die wissen möchten, über welche REST-Anwendung eine Anwendung oder Datenquelle erstellt wurde.
activityType integer Die Art der Aktivität, die diese Sitzung darstellt.
activeTimeMillis long Sitzungsdauer in Sitzung. Während „start_time_millis“ und „end_time_millis“ die volle Sitzungsdauer definieren, kann die aktive Zeit kürzer sein und durch „active_time_millis“ angegeben werden. Wenn die Inaktivitätszeit während der Sitzung bekannt ist, sollte sie auch über einen com.google.activity.segment-Datenpunkt mit einem STILL-Aktivitätswert

eingefügt werden

Testen!

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.