Wyświetla listę utworzonych wcześniej sesji. Wypróbuj teraz
Żądanie
Żądanie HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Parametry
Nazwa parametru | Wartość | Opis |
---|---|---|
Parametry ścieżki | ||
userId |
string |
Wymień sesje danej osoby. Użyj me , aby wskazać uwierzytelnionego użytkownika. Obecnie obsługiwany jest tylko typ me .
|
Opcjonalne parametry zapytania | ||
activityType |
integer |
Jeśli pole nie jest puste, powinny być zwracane tylko sesje z tymi typami aktywności. |
endTime |
string |
Sygnatura czasowa RFC3339. W odpowiedzi będą uwzględniane tylko sesje kończące się między godziną rozpoczęcia a zakończeniem. Jeśli pominiesz ten czas, ale określisz startTime, wszystkie sesje od startTime do końca zostaną zwrócone. |
includeDeleted |
boolean |
Jeśli ma wartość prawda i pominięto zarówno startTime, jak i endTime, zostaną usunięte usunięcia sesji. |
pageToken |
string |
Token kontynuacji, który służy do przyrostowej synchronizacji.
Aby uzyskać kolejną grupę zmian, ustaw ten parametr na wartość nextPageToken z poprzedniej odpowiedzi. Token strony jest ignorowany, jeśli określono czas rozpoczęcia lub zakończenia. Jeśli nie podasz godziny rozpoczęcia, czasu zakończenia i tokena strony, zostaną zwrócone sesje zmodyfikowane w ciągu ostatnich 30 dni.
|
startTime |
string |
Sygnatura czasowa RFC3339. W odpowiedzi będą uwzględniane tylko sesje kończące się między godziną rozpoczęcia a zakończeniem. Jeśli pominiesz ten czas, ale określisz endTime, zostaną zwrócone wszystkie sesje od początku do endTime. |
Autoryzacja
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 uwierzytelniania i autoryzacji.
Treść żądania
Nie używaj w tej metodzie treści żądania.
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:
{ "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 właściwości | Wartość | Opis | Uwagi |
---|---|---|---|
session[] |
list |
Sesje z czasem zakończenia wynoszącym od startTime do endTime żądania. |
|
session[].id |
string |
Wygenerowany przez klienta identyfikator, który jest unikalny dla wszystkich sesji danego użytkownika. | |
session[].name |
string |
Czytelna dla człowieka nazwa sesji. | |
session[].description |
string |
Opis tej sesji. | |
session[].startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki. | |
session[].endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki. | |
session[].modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca, kiedy sesja została ostatnio zmodyfikowana. | |
session[].application |
nested object |
Aplikacja, która utworzyła sesję. | |
session[].application.packageName |
string |
Nazwa pakietu tej aplikacji. Używa się go jako unikalnego identyfikatora podczas tworzenia przez aplikacje na Androida, ale nie można go określić przez klientów typu REST. Klienty REST będą miały widoczny numer projektu w identyfikatorze strumienia danych, a nie identyfikator pakiety. | |
session[].application.version |
string |
Wersja aplikacji. Musisz zaktualizować 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żyć do połączenia z aplikacją. | |
session[].application.name |
string |
Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy unikalnych nazw. Inną opcją jest wygodne dla innych deweloperów, którzy chcą określić, który REST utworzył aplikację lub źródło danych. | |
session[].activityType |
integer |
Rodzaj aktywności danej sesji. | |
deletedSession[] |
list |
Jeśli w żądaniu parametr includeDeleted ma wartość Prawda, a elementy startTime i endTime są pominięte, uwzględnione będą sesje, które zostały usunięte od ostatniej synchronizacji. |
|
deletedSession[].id |
string |
Wygenerowany przez klienta identyfikator, który jest unikalny dla wszystkich sesji danego użytkownika. | |
deletedSession[].name |
string |
Czytelna dla człowieka nazwa sesji. | |
deletedSession[].description |
string |
Opis tej sesji. | |
deletedSession[].startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki. | |
deletedSession[].endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki. | |
deletedSession[].modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca, kiedy sesja została ostatnio zmodyfikowana. | |
deletedSession[].application |
nested object |
Aplikacja, która utworzyła sesję. | |
deletedSession[].application.packageName |
string |
Nazwa pakietu tej aplikacji. Używa się go jako unikalnego identyfikatora podczas tworzenia przez aplikacje na Androida, ale nie można go określić przez klientów typu REST. Klienty REST będą miały widoczny numer projektu w identyfikatorze strumienia danych, a nie identyfikator pakiety. | |
deletedSession[].application.version |
string |
Wersja aplikacji. Musisz zaktualizować 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żyć do połączenia z aplikacją. | |
deletedSession[].application.name |
string |
Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy unikalnych nazw. Inną opcją jest wygodne dla innych deweloperów, którzy chcą określić, który REST utworzył aplikację lub źródło danych. | |
deletedSession[].activityType |
integer |
Rodzaj aktywności danej sesji. | |
nextPageToken |
string |
Token synchronizacji, który służy do synchronizacji kolejnych zmian. Ten atrybut zostanie podany tylko wtedy, gdy startTime i endTime zostaną pominięte w żądaniu. | |
session[].activeTimeMillis |
long |
Czas aktywności sesji. Choć parametry start_time_millis i end_time_millis definiują pełny czas trwania sesji, to czas aktywności może być krótszy, a parametr Active_time_millis – krótszy. Jeśli czas bezczynności jest znany podczas sesji, należy go wstawić przez punkt danych com.google.activity.segment z wartością STILL |
|
deletedSession[].activeTimeMillis |
long |
Czas aktywności sesji. Choć parametry start_time_millis i end_time_millis definiują pełny czas trwania sesji, to czas aktywności może być krótszy, a parametr Active_time_millis – krótszy. Jeśli czas bezczynności jest znany podczas sesji, należy go wstawić przez punkt danych com.google.activity.segment z wartością STILL |
|
hasMoreData |
boolean |
Flaga wskazująca, że na serwerze znajduje się więcej danych do przeniesienia. NIE używaj tego pola. Nigdy nie wypełniają odpowiedzi serwera. |
Wypróbuj
Skorzystaj z eksploratora interfejsów API poniżej, aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź.