Wyświetla listę utworzonych wcześniej sesji. Wypróbuj teraz
Prośba
Żądanie HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry ścieżki | ||
userId |
string |
Wyświetl listę sesji dla zidentyfikowanej osoby. Użyj me , aby wskazać uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko wartość me .
|
Opcjonalne parametry zapytania | ||
activityType |
integer |
Jeśli pole nie jest puste, zwracane powinny być tylko sesje z tymi typami aktywności. |
endTime |
string |
Sygnatura czasowa RFC3339. W odpowiedzi zostaną uwzględnione tylko sesje zakończone między godziną rozpoczęcia i zakończenia. Jeśli ten czas zostanie pominięty, ale określona jest wartość startTime, zwrócone zostaną wszystkie sesje od startTime do końca czasu. |
includeDeleted |
boolean |
Jeśli ma wartość true i pominięto zarówno zasady startTime, jak i endTime, usunięcia sesji zostaną zwrócone. |
pageToken |
string |
Token kontynuacji, który służy do synchronizacji przyrostowej.
Aby pobrać następną grupę zmian, ustaw ten parametr na wartość nextPageToken z poprzedniej odpowiedzi. Jeśli podany jest czas rozpoczęcia lub zakończenia, token strony jest ignorowany. Jeśli nie podasz godziny rozpoczęcia ani zakończenia ani tokena strony, zwracane są sesje zmodyfikowane w ciągu ostatnich 30 dni.
|
startTime |
string |
Sygnatura czasowa RFC3339. W odpowiedzi zostaną uwzględnione tylko sesje zakończone między godziną rozpoczęcia i zakończenia. Jeśli pominiesz tę godzinę, ale podasz właściwość endTime, zwrócone zostaną wszystkie sesje od początku do endTime. |
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:
Zakres |
---|
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 |
Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.
Treść żądania
Nie podawaj treści żądania za pomocą tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{ "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 }
nazwa usługi, | Wartość | Opis | Notatki |
---|---|---|---|
session[] |
list |
Sesje, których czas zakończenia mieści się w zakresie od startTime do endTime żądania. |
|
session[].id |
string |
Identyfikator wygenerowany przez klienta, który jest unikalny we wszystkich sesjach danego użytkownika. | |
session[].name |
string |
Czytelna dla człowieka nazwa sesji. | |
session[].description |
string |
Opis sesji. | |
session[].startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki włącznie. | |
session[].endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki włącznie. | |
session[].modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca czas ostatniej modyfikacji sesji. | |
session[].application |
nested object |
Aplikacja, która utworzyła sesję. | |
session[].application.packageName |
string |
Nazwa pakietu tej aplikacji. Jest używany jako unikalny identyfikator utworzony przez aplikacje na Androida, ale klienty REST nie mogą go określać. Numer projektu klienta REST będzie odzwierciedlony w identyfikatorach strumienia danych źródła danych, a nie w polu packageName. | |
session[].application.version |
string |
Wersja aplikacji. Należy aktualizować to pole za każdym razem, gdy aplikacja zmieni się w sposób, który ma wpływ na obliczanie danych. | |
session[].application.detailsUrl |
string |
Opcjonalny identyfikator URI, którego można używać do odsyłania do aplikacji. | |
session[].application.name |
string |
Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie wymuszamy unikalności tej nazwy. Udostępniamy ją dla wygody innych programistów, którzy chcą określić, który interfejs REST utworzył aplikację lub źródło danych. | |
session[].activityType |
integer |
Typ aktywności reprezentowanej przez tę sesję. | |
deletedSession[] |
list |
Jeśli includeDeleted ma w żądaniu wartość „prawda”, a pominięte zasady startTime i endTime są pominięte, obejmie to sesje, które zostały usunięte od ostatniej synchronizacji. |
|
deletedSession[].id |
string |
Identyfikator wygenerowany przez klienta, który jest unikalny we wszystkich sesjach danego użytkownika. | |
deletedSession[].name |
string |
Czytelna dla człowieka nazwa sesji. | |
deletedSession[].description |
string |
Opis sesji. | |
deletedSession[].startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki włącznie. | |
deletedSession[].endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki włącznie. | |
deletedSession[].modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca czas ostatniej modyfikacji sesji. | |
deletedSession[].application |
nested object |
Aplikacja, która utworzyła sesję. | |
deletedSession[].application.packageName |
string |
Nazwa pakietu tej aplikacji. Jest używany jako unikalny identyfikator utworzony przez aplikacje na Androida, ale klienty REST nie mogą go określać. Numer projektu klienta REST będzie odzwierciedlony w identyfikatorach strumienia danych źródła danych, a nie w polu packageName. | |
deletedSession[].application.version |
string |
Wersja aplikacji. Należy aktualizować to pole za każdym razem, gdy aplikacja zmieni się w sposób, który ma wpływ na obliczanie danych. | |
deletedSession[].application.detailsUrl |
string |
Opcjonalny identyfikator URI, którego można używać do odsyłania do aplikacji. | |
deletedSession[].application.name |
string |
Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie wymuszamy unikalności tej nazwy. Udostępniamy ją dla wygody innych programistów, którzy chcą określić, który interfejs REST utworzył aplikację lub źródło danych. | |
deletedSession[].activityType |
integer |
Typ aktywności reprezentowanej przez tę sesję. | |
nextPageToken |
string |
Token synchronizacji, który służy do synchronizowania kolejnych zmian. Zostanie ona podana tylko wtedy, gdy w żądaniu pominięto zarówno parametry startTime, jak i endTime. | |
session[].activeTimeMillis |
long |
Czas aktywności sesji. Podczas gdy czas start_time_millis i end_time_millis określają pełny czas sesji, czas aktywności może być krótszy i określony za pomocą parametru activity_time_millis. Jeśli czas braku aktywności w trakcie sesji jest znany, należy go też wstawić za pomocą punktu danych com.google.activity.segment z wartością aktywności STILL |
|
deletedSession[].activeTimeMillis |
long |
Czas aktywności sesji. Podczas gdy czas start_time_millis i end_time_millis określają pełny czas sesji, czas aktywności może być krótszy i określony za pomocą parametru activity_time_millis. Jeśli czas braku aktywności w trakcie sesji jest znany, należy go też wstawić za pomocą punktu danych com.google.activity.segment z wartością aktywności STILL |
|
hasMoreData |
boolean |
Flaga wskazująca, że serwer ma więcej danych do przesłania. NIE UŻYWAJ TEGO POLA. Nigdy nie jest wypełniane w odpowiedziach z serwera. |
Wypróbuj
Użyj eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.