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. Verwenden Sie me , um den authentifizierten Nutzer anzugeben. 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 den Start- und Endzeiten enden, werden in die Antwort aufgenommen. Wenn diese Zeit weggelassen, aber startTime angegeben wird, werden alle Sitzungen von startTime bis zum Ende zurückgegeben. |
includeDeleted |
boolean |
Wenn der Wert „true“ ist und sowohl startTime als auch endTime weggelassen werden, werden Sitzungslöschungen zurückgegeben. |
pageToken |
string |
Das Fortsetzungstoken, das für die inkrementelle Synchronisierung verwendet wird.
Um den nächsten Batch von Änderungen zu erhalten, legen Sie diesen Parameter auf den Wert von nextPageToken aus der vorherigen Antwort fest. Das Seitentoken wird ignoriert, wenn eine Start- oder Endzeit angegeben ist. Wenn keine Start- und Endzeit sowie kein Seitentoken angegeben ist, werden die in den letzten 30 Tagen geänderten Sitzungen zurückgegeben.
|
startTime |
string |
Ein RFC3339-Zeitstempel. Nur Sitzungen, die zwischen den Start- und Endzeiten enden, werden in die Antwort aufgenommen. Wenn diese Zeit weggelassen, aber endTime angegeben wird, 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:
Bereich |
---|
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, die zwischen startTime und endTime der Anfrage liegt. |
|
session[].id |
string |
Eine vom Client generierte Kennung, die für alle Sitzungen dieses bestimmten 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 der Epoche (einschließlich). | |
session[].endTimeMillis |
long |
Eine Endzeit in Millisekunden seit der Epoche (einschließlich). | |
session[].modifiedTimeMillis |
long |
Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde. | |
session[].application |
nested object |
Die Anwendung, in der die Sitzung erstellt wurde. | |
session[].application.packageName |
string |
Paketname für diese Anwendung. Er wird als eindeutige Kennung verwendet, wenn er von Android-Apps erstellt wird. Für REST-Clients kann er nicht angegeben werden. Bei REST-Clients wird die Entwicklerprojektnummer in den Datenquellen-Datenstream-IDs anstelle des Paketnamens widergespiegelt. | |
session[].application.version |
string |
Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung auf eine Weise ändert, die sich auf die Berechnung der Daten auswirkt. | |
session[].application.detailsUrl |
string |
Ein optionaler URI, mit dem zurück zur Anwendung verlinkt 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 wird anderen Entwicklern zur Verfügung gestellt, die ermitteln möchten, welche REST-Anwendung eine Anwendung oder Datenquelle erstellt hat. | |
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 bestimmten 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 der Epoche (einschließlich). | |
deletedSession[].endTimeMillis |
long |
Eine Endzeit in Millisekunden seit der Epoche (einschließlich). | |
deletedSession[].modifiedTimeMillis |
long |
Ein Zeitstempel, der angibt, wann die Sitzung zuletzt geändert wurde. | |
deletedSession[].application |
nested object |
Die Anwendung, in der die Sitzung erstellt wurde. | |
deletedSession[].application.packageName |
string |
Paketname für diese Anwendung. Er wird als eindeutige Kennung verwendet, wenn er von Android-Apps erstellt wird. Für REST-Clients kann er nicht angegeben werden. Bei REST-Clients wird die Entwicklerprojektnummer in den Datenquellen-Datenstream-IDs anstelle des Paketnamens widergespiegelt. | |
deletedSession[].application.version |
string |
Version der Anwendung. Sie sollten dieses Feld immer dann aktualisieren, wenn sich die Anwendung auf eine Weise ändert, die sich auf die Berechnung der Daten auswirkt. | |
deletedSession[].application.detailsUrl |
string |
Ein optionaler URI, mit dem zurück zur Anwendung verlinkt 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 wird anderen Entwicklern zur Verfügung gestellt, die ermitteln möchten, welche REST-Anwendung eine Anwendung oder Datenquelle erstellt hat. | |
deletedSession[].activityType |
integer |
Die Art der Aktivität, die diese Sitzung darstellt. | |
nextPageToken |
string |
Das Synchronisierungstoken, mit dem weitere Änderungen synchronisiert werden. Dieser Parameter 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 gesamte 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 |
Aktive Zeit der Sitzung. Während start_time_millis und end_time_millis die gesamte 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 der Server mehr Daten für die Übertragung hat. VERWENDE DIESES FELD NICHT. Es wird in Antworten vom Server nie mit Daten gefüllt. |
Jetzt testen
Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.