Users.sessions: update

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