Users.sessions: update

Umożliwia zaktualizowanie lub wstawienie danej sesji. Wypróbuj

Żą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 dla zidentyfikowanej osoby. Użyj me, aby wskazać, uwierzytelnionego użytkownika. Obecnie obsługiwana jest tylko forma me.

Autoryzacja

To żądanie wymaga autoryzacji w tym zakresie:

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

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

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 Uwagi
id string Wygenerowany przez klienta identyfikator, który jest unikalny we wszystkich sesjach tego konkretnego użytkownika.
name string Zrozumiała dla człowieka nazwa sesji.
description string Opis tej sesji.
startTimeMillis long Godzina rozpoczęcia w milisekundach od początku epoki.
endTimeMillis long Godzina zakończenia w milisekundach od początku epoki.
modifiedTimeMillis long Sygnatura czasowa określająca, kiedy sesja została ostatnio zmodyfikowana.
application nested object Aplikacja, która utworzyła sesję.
application.packageName string Nazwa pakietu tej aplikacji. Jest używany jako unikalny identyfikator w przypadku aplikacji na Androida, ale nie może być określony przez klienty REST. W identyfikatorach strumieni danych źródła danych w przypadku klientów REST zamiast wartości packageName będzie widoczny numer projektu programistycznego.
application.version string Wersja aplikacji. Pole należy aktualizować za każdym razem, gdy aplikacja zmienia się w sposób, który wpływa na obliczenia danych.
application.detailsUrl string Opcjonalny identyfikator URI, za pomocą którego można utworzyć link z powrotem do aplikacji.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
activityType integer Typ aktywności reprezentowany przez tę sesję.
activeTimeMillis long Czas aktywności sesji. Czasy start_time_millis i end_time_millis określają czas trwania całej sesji, natomiast czas aktywności może być krótszy i określony za pomocą parametru Active_time_millis. Jeśli jest znany czas braku aktywności w trakcie sesji, 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 Uwagi
id string Wygenerowany przez klienta identyfikator, który jest unikalny we wszystkich sesjach tego konkretnego użytkownika.
name string Zrozumiała dla człowieka nazwa sesji.
description string Opis tej sesji.
startTimeMillis long Godzina rozpoczęcia w milisekundach od początku epoki.
endTimeMillis long Godzina zakończenia w milisekundach od początku epoki.
modifiedTimeMillis long Sygnatura czasowa określająca, kiedy sesja została ostatnio zmodyfikowana.
application nested object Aplikacja, która utworzyła sesję.
application.packageName string Nazwa pakietu tej aplikacji. Jest używany jako unikalny identyfikator w przypadku aplikacji na Androida, ale nie może być określony przez klienty REST. W identyfikatorach strumieni danych źródła danych w przypadku klientów REST zamiast wartości packageName będzie widoczny numer projektu programistycznego.
application.version string Wersja aplikacji. Pole należy aktualizować za każdym razem, gdy aplikacja zmienia się w sposób, który wpływa na obliczenia danych.
application.detailsUrl string Opcjonalny identyfikator URI, za pomocą którego można utworzyć link z powrotem do aplikacji.
application.name string Nazwa tej aplikacji. Jest to wymagane w przypadku klientów REST, ale nie egzekwujemy niepowtarzalności tej nazwy. Jest ona udostępniana dla innych programistów, którzy chcą określić, który model REST utworzył aplikację lub źródło danych.
activityType integer Typ aktywności reprezentowany przez tę sesję.
activeTimeMillis long Czas aktywności sesji. Czasy start_time_millis i end_time_millis określają czas trwania całej sesji, natomiast czas aktywności może być krótszy i określony za pomocą parametru Active_time_millis. Jeśli jest znany czas braku aktywności w trakcie sesji, należy go też wstawić za pomocą punktu danych com.google.activity.segment z wartością aktywności STILL

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.