Users.sessions: list

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ź.