Users.sessions: update

Aktualizuje lub wstawia dane danej sesji. Wypróbuj teraz

Żądanie

Żądanie HTTP

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

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
sessionId string Identyfikator sesji, która ma zostać utworzona.
userId string Utwórz sesje określonej osoby. Użyj me, aby wskazać uwierzytelnionego użytkownika. Obecnie obsługiwany jest tylko typ me.

Autoryzacja

To żądanie wymaga autoryzacji w następującym zakresie:

Zakres
https://www.googleapis.com/auth/fitness.activity.write

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

Dane w treści żądania muszą mieć poniższy format:

{
  "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
}
Nazwa właściwości Wartość Opis Uwagi
id string Wygenerowany przez klienta identyfikator, który jest unikalny dla wszystkich sesji danego użytkownika.
name string Czytelna dla człowieka nazwa sesji.
description string Opis tej sesji.
startTimeMillis long Czas rozpoczęcia w milisekundach od początku epoki.
endTimeMillis long Czas zakończenia w milisekundach od początku epoki.
modifiedTimeMillis long Sygnatura czasowa wskazująca, kiedy sesja została ostatnio zmodyfikowana.
application nested object Aplikacja, która utworzyła sesję.
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.
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.
application.detailsUrl string Opcjonalny identyfikator URI, którego można użyć do połączenia z aplikacją.
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.
activityType integer Rodzaj aktywności danej sesji.
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

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "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
}
Nazwa właściwości Wartość Opis Uwagi
id string Wygenerowany przez klienta identyfikator, który jest unikalny dla wszystkich sesji danego użytkownika.
name string Czytelna dla człowieka nazwa sesji.
description string Opis tej sesji.
startTimeMillis long Czas rozpoczęcia w milisekundach od początku epoki.
endTimeMillis long Czas zakończenia w milisekundach od początku epoki.
modifiedTimeMillis long Sygnatura czasowa wskazująca, kiedy sesja została ostatnio zmodyfikowana.
application nested object Aplikacja, która utworzyła sesję.
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.
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.
application.detailsUrl string Opcjonalny identyfikator URI, którego można użyć do połączenia z aplikacją.
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.
activityType integer Rodzaj aktywności danej sesji.
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

Wypróbuj

Skorzystaj z eksploratora interfejsów API poniżej, aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź.