Users.sessions: list

Listet zuvor erstellte Sitzungen auf. Jetzt testen

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
userId string Listen Sie Sitzungen für die identifizierte Person auf. Mit me geben Sie mit dem authentifizierten Nutzer. Derzeit wird nur me unterstützt.
Optionale Abfrageparameter
activityType integer Wenn das Feld nicht leer ist, sollten nur Sitzungen mit diesen Aktivitätstypen zurückgegeben werden.
endTime string Ein RFC3339-Zeitstempel. Nur Sitzungen, die zwischen Start- und Endzeit enden, werden in die auf die Antwort. Wenn dieser Zeitpunkt weggelassen wird, aber startTime gleich werden alle Sitzungen vom startTime bis zum Ende zurückgegeben werden kann.
includeDeleted boolean Falls wahr und sowohl startTime als auch endTime sind ausgelassen, werden Löschvorgänge für Sitzungen zurückgegeben.
pageToken string Das Fortsetzungstoken, das für die inkrementelle Synchronisierung verwendet wird. Um den nächsten Batch mit Änderungen abzurufen, legen Sie für diesen Parameter den Wert nextPageToken aus der vorherigen Antwort. Das Seitentoken ist wird ignoriert, wenn entweder die Start- oder die Endzeit angegeben ist. Wenn keine Startzeit, Ende und das Seitentoken angegeben ist, werden Sitzungen 30 Tage zurückerstattet werden.
startTime string Ein RFC3339-Zeitstempel. Nur Sitzungen, die zwischen Start- und Endzeit enden, werden in die auf die Antwort. Wird diese Zeit weggelassen, aber endTime angegeben, 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 einer Endzeit zwischen startTime und endTime der Anfrage.

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 dieser Sitzung.
session[].startTimeMillis long Eine Startzeit in Millisekunden seit einschließlich Epoche.
session[].endTimeMillis long Eine Endzeit in Millisekunden seit Epoche (einschließlich).
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-Anwendungen erstellt wird, kann aber nicht von REST-Clients angegeben werden. Bei REST-Clients wird die Nummer des Entwicklerprojekts in den Datenstream-IDs der Datenquelle anstatt im packageName angezeigt.
session[].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.
session[].application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung zurück 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 für andere Entwickler gedacht, die wissen möchten, mit welcher REST eine Anwendung oder Datenquelle erstellt wurde.
session[].activityType integer Der Aktivitätstyp dieser Sitzung.
deletedSession[] list Wenn includeDeleted in der Anfrage auf „true“ festgelegt ist und startTime und endTime weggelassen werden, sind darin Sitzungen enthalten, 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 dieser Sitzung.
deletedSession[].startTimeMillis long Eine Startzeit in Millisekunden seit einschließlich Epoche.
deletedSession[].endTimeMillis long Eine Endzeit in Millisekunden seit Epoche (einschließlich).
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-Anwendungen erstellt wird, kann aber nicht von REST-Clients angegeben werden. Bei REST-Clients wird die Nummer des Entwicklerprojekts in den Datenstream-IDs der Datenquelle anstatt im packageName angezeigt.
deletedSession[].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.
deletedSession[].application.detailsUrl string Ein optionaler URI, mit dem eine Verknüpfung zurück 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 für andere Entwickler gedacht, die wissen möchten, mit welcher REST eine Anwendung oder Datenquelle erstellt wurde.
deletedSession[].activityType integer Der Aktivitätstyp dieser Sitzung.
nextPageToken string Das Synchronisierungstoken, mit dem weitere Änderungen synchronisiert werden. Wird nur angegeben, wenn sowohl startTime als auch endTime in der Anfrage weggelassen werden.
session[].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

deletedSession[].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

hasMoreData boolean Flag, das angibt, dass auf dem Server mehr Daten zu übertragen sind. VERWENDEN SIE DIESES FELD NICHT. Er wird in Antworten des Servers nie eingefügt.

Testen!

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