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