Users.sessions: list

Wyświetla listę wcześniej utworzonych sesji. Wypróbuj

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/sessions

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
userId string Wyświetl sesje związane ze zidentyfikowaną osobą. Użyj me, aby wskazać, uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko forma 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. Uwzględniane będą tylko sesje kończące się między godziną rozpoczęcia a zakończeniem odpowiedź. Jeśli ta godzina zostanie pominięta, ale startTime to wszystkie sesje od startTime do końca okresu .
includeDeleted boolean Jeśli ma wartość prawda, a startTime i endTime mają wartość zostanie pominięty, zostaną zwrócone usunięcia sesji.
pageToken string Token kontynuacji, który jest używany do synchronizacji przyrostowej. Aby pobrać kolejną grupę zmian, ustaw ten parametr na wartość nextPageToken od poprzedniej odpowiedzi. Token strony to jest ignorowana, jeśli podano czas rozpoczęcia lub zakończenia. Jeśli nie ma godziny rozpoczęcia, czas zakończenia i token strony, sesje zmodyfikowane w ciągu Zwracane jest 30 dni.
startTime string Sygnatura czasowa RFC3339. Uwzględniane będą tylko sesje kończące się między godziną rozpoczęcia a zakończeniem odpowiedź. Jeśli pominiesz tę godzinę, ale określisz endTime, wszystkie sesje od początku godziny do endTime będą .

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 dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

Nie podawaj treści żądania przy użyciu 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 Uwagi
session[] list Sesje z czasem zakończenia mieszczącym się między startTime a endTime żądania.

session[].id string Wygenerowany przez klienta identyfikator, który jest unikalny we wszystkich sesjach tego konkretnego użytkownika.
session[].name string Zrozumiała dla człowieka nazwa sesji.
session[].description string Opis tej sesji.
session[].startTimeMillis long Godzina rozpoczęcia w milisekundach od początku epoki.
session[].endTimeMillis long Godzina zakończenia w milisekundach od początku epoki.
session[].modifiedTimeMillis long Sygnatura czasowa określają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. Jest używany jako unikalny identyfikator w przypadku aplikacji na Androida, ale nie może być określony przez klienty REST. W identyfikatorach strumieni danych źródła danych w przypadku klientów REST zamiast wartości packageName będzie widoczny numer projektu programistycznego.
session[].application.version string Wersja aplikacji. Pole należy aktualizować za każdym razem, gdy aplikacja zmienia się w sposób, który wpływa na obliczenia danych.
session[].application.detailsUrl string Opcjonalny identyfikator URI, za pomocą którego można utworzyć link z powrotem do aplikacji.
session[].application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
session[].activityType integer Typ aktywności reprezentowany przez tę sesję.
deletedSession[] list Jeśli w żądaniu zasada includeDeleted ma wartość Prawda, a parametry startTime i endTime są pominięte, obejmuje to sesje, które zostały usunięte od ostatniej synchronizacji.
deletedSession[].id string Wygenerowany przez klienta identyfikator, który jest unikalny we wszystkich sesjach tego konkretnego użytkownika.
deletedSession[].name string Zrozumiała dla człowieka nazwa sesji.
deletedSession[].description string Opis tej sesji.
deletedSession[].startTimeMillis long Godzina rozpoczęcia w milisekundach od początku epoki.
deletedSession[].endTimeMillis long Godzina zakończenia w milisekundach od początku epoki.
deletedSession[].modifiedTimeMillis long Sygnatura czasowa określają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. Jest używany jako unikalny identyfikator w przypadku aplikacji na Androida, ale nie może być określony przez klienty REST. W identyfikatorach strumieni danych źródła danych w przypadku klientów REST zamiast wartości packageName będzie widoczny numer projektu programistycznego.
deletedSession[].application.version string Wersja aplikacji. Pole należy aktualizować za każdym razem, gdy aplikacja zmienia się w sposób, który wpływa na obliczenia danych.
deletedSession[].application.detailsUrl string Opcjonalny identyfikator URI, za pomocą którego można utworzyć link z powrotem do aplikacji.
deletedSession[].application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
deletedSession[].activityType integer Typ aktywności reprezentowany przez tę sesję.
nextPageToken string Token synchronizacji, który jest używany do synchronizowania dalszych zmian. Ta wartość będzie podana tylko wtedy, gdy w żądaniu pominiesz zarówno startTime, jak i endTime.
session[].activeTimeMillis long Czas aktywności sesji. Czasy start_time_millis i end_time_millis określają czas trwania całej sesji, natomiast czas aktywności może być krótszy i określony za pomocą parametru Active_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. Czasy start_time_millis i end_time_millis określają czas trwania całej sesji, natomiast czas aktywności może być krótszy i określony za pomocą parametru Active_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 z informacją, że serwer ma więcej danych do przesłania. NIE UŻYWAĆ TEGO POLA. Nie jest on nigdy wypełniany w odpowiedziach z serwera.

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.