Users.sessions: list

Listet Sitzungen auf, die zuvor erstellt wurden. Jetzt testen.

Anfrage

HTTP-Anfrage

GET https://www.googleapis.com/fitness/v1/users/userId/sessions

Parameter

Parametername Wert Beschreibung
Pfadparameter
userId string Listet Sitzungen für die identifizierte Person auf. Verwenden Sie me, um den authentifizierten Nutzer anzugeben. Derzeit wird nur me unterstützt.
Optionale Suchparameter
activityType integer Wenn das Feld nicht leer ist, sollten nur Sitzungen mit diesen Aktivitätstypen zurückgegeben werden.
endTime string Ein RFC3339-Zeitstempel. In die Antwort werden nur Sitzungen aufgenommen, die zwischen den Start- und Endzeiten enden. Wenn dieser Zeitraum weggelassen wird, aber startTime angegeben ist, werden alle Sitzungen von startTime bis zum Ende zurückgegeben.
includeDeleted boolean Wenn „true“ festgelegt ist und sowohl startTime als auch endTime weggelassen werden, wird das Löschen von Sitzungen zurückgegeben.
pageToken string Das Fortsetzungs-Token für die inkrementelle Synchronisierung. Um den nächsten Batch von Änderungen abzurufen, legen Sie diesen Parameter auf den Wert von nextPageToken aus der vorherigen Antwort fest. Das Seitentoken wird ignoriert, wenn entweder die Startzeit oder die Endzeit angegeben ist. Wenn weder der Beginn noch das Ende oder das Seitentoken angegeben sind, werden die in den letzten 30 Tagen geänderten Sitzungen zurückgegeben.
startTime string Ein RFC3339-Zeitstempel. In die Antwort werden nur Sitzungen aufgenommen, die zwischen den Start- und Endzeiten enden. Wenn dieser Zeitraum weggelassen wird, aber endTime angegeben ist, werden alle Sitzungen vom Beginn bis zum endTime zurückgegeben.

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

Umfang
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "session": [
    {
      "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
    }
  ],
  "deletedSession": [
    {
      "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
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
Name der Eigenschaft Wert Beschreibung Hinweise
session[] list Sitzungen mit einem Endzeitpunkt, der zwischen startTime und endTime der Anfrage liegt.

session[].id string Eine vom Client generierte Kennung, die für alle Sitzungen dieses Nutzers eindeutig ist.
session[].name string Ein für Menschen lesbarer Name der Sitzung.
session[].description string Eine Beschreibung für diese Sitzung.
session[].startTimeMillis long Eine Startzeit in Millisekunden seit Beginn der Epoche.
session[].endTimeMillis long Eine Endzeit in Millisekunden seit Epoche.
session[].modifiedTimeMillis long Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde.
session[].application nested object Die Anwendung, die die Sitzung erstellt hat.
session[].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.
session[].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.
session[].application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung zur Anwendung hergestellt werden kann.
session[].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.
session[].activityType integer Die Art der Aktivität, die diese Sitzung darstellt.
deletedSession[] list Wenn includeDeleted in der Anfrage auf „true“ gesetzt ist und startTime und endTime weggelassen werden, werden Sitzungen berücksichtigt, die seit der letzten Synchronisierung gelöscht wurden.
deletedSession[].id string Eine vom Client generierte Kennung, die für alle Sitzungen dieses Nutzers eindeutig ist.
deletedSession[].name string Ein für Menschen lesbarer Name der Sitzung.
deletedSession[].description string Eine Beschreibung für diese Sitzung.
deletedSession[].startTimeMillis long Eine Startzeit in Millisekunden seit Beginn der Epoche.
deletedSession[].endTimeMillis long Eine Endzeit in Millisekunden seit Epoche.
deletedSession[].modifiedTimeMillis long Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde.
deletedSession[].application nested object Die Anwendung, die die Sitzung erstellt hat.
deletedSession[].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.
deletedSession[].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.
deletedSession[].application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung zur Anwendung hergestellt werden kann.
deletedSession[].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.
deletedSession[].activityType integer Die Art der Aktivität, die diese Sitzung darstellt.
nextPageToken string Das Synchronisierungstoken, das zum Synchronisieren weiterer Änderungen verwendet wird. Er wird nur angegeben, wenn sowohl startTime als auch endTime in der Anfrage weggelassen wurden.
session[].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
deletedSession[].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
hasMoreData boolean Flag, das angibt, dass für den Server mehr Daten zu übertragen sind. DIESES FELD NICHT VERWENDEN. Er wird nie in Antworten vom Server eingefügt.

Testen!

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