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.