Ta strona została przetłumaczona przez Cloud Translation API.

Users.sessions: list

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