Aktualizuje lub wstaw dane sesji. Wypróbuj teraz
Prośba
Żą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 dla zidentyfikowanej osoby. Użyj me , aby wskazać uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko wartość me .
|
Upoważnienie
To żądanie wymaga autoryzacji w tym zakresie:
Zakres |
---|
https://www.googleapis.com/auth/fitness.activity.write |
Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.
Treść żądania
Dane w treści żądania podaj w następującej strukturze:
{ "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 usługi, | Wartość | Opis | Notatki |
---|---|---|---|
id |
string |
Identyfikator wygenerowany przez klienta, który jest unikalny we wszystkich sesjach danego użytkownika. | |
name |
string |
Czytelna dla człowieka nazwa sesji. | |
description |
string |
Opis sesji. | |
startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki włącznie. | |
endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki włącznie. | |
modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca czas ostatniej modyfikacji sesji. | |
application |
nested object |
Aplikacja, która utworzyła sesję. | |
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. | |
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. | |
application.detailsUrl |
string |
Opcjonalny identyfikator URI, którego można używać do odsyłania do aplikacji. | |
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. | |
activityType |
integer |
Typ aktywności reprezentowanej przez tę sesję. | |
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 |
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{ "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 usługi, | Wartość | Opis | Notatki |
---|---|---|---|
id |
string |
Identyfikator wygenerowany przez klienta, który jest unikalny we wszystkich sesjach danego użytkownika. | |
name |
string |
Czytelna dla człowieka nazwa sesji. | |
description |
string |
Opis sesji. | |
startTimeMillis |
long |
Czas rozpoczęcia w milisekundach od początku epoki włącznie. | |
endTimeMillis |
long |
Czas zakończenia w milisekundach od początku epoki włącznie. | |
modifiedTimeMillis |
long |
Sygnatura czasowa wskazująca czas ostatniej modyfikacji sesji. | |
application |
nested object |
Aplikacja, która utworzyła sesję. | |
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. | |
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. | |
application.detailsUrl |
string |
Opcjonalny identyfikator URI, którego można używać do odsyłania do aplikacji. | |
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. | |
activityType |
integer |
Typ aktywności reprezentowanej przez tę sesję. | |
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 |
Wypróbuj
Użyj eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.