Users.sessions: update

Atualiza ou insere uma determinada sessão. Faça o teste agora.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
sessionId string ID da sessão a ser criada.
userId string Crie sessões para a pessoa identificada. Use me para indicar o usuário autenticado. Somente me é compatível no momento.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

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

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, forneça os dados com a seguinte estrutura:

{
  "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
}
Nome da propriedade Valor Descrição Observações
id string Um identificador gerado pelo cliente que é exclusivo em todas as sessões desse usuário específico.
name string É um nome legível da sessão.
description string É uma descrição para esta sessão.
startTimeMillis long Um horário de início, em milissegundos desde a época, inclusive.
endTimeMillis long Um horário de término, em milissegundos desde a época, inclusive.
modifiedTimeMillis long Carimbo de data/hora que indica quando a sessão foi modificada pela última vez.
application nested object O aplicativo que criou a sessão.
application.packageName string Nome do pacote para este aplicativo. Ele é usado como um identificador exclusivo quando criado por aplicativos Android, mas não pode ser especificado por clientes REST. Os clientes REST terão o número do projeto do desenvolvedor refletido nos IDs do fluxo de dados da fonte de dados, em vez do packageName.
application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo mudar de modo que afete o cálculo dos dados.
application.detailsUrl string Um URI opcional que pode ser usado para vincular ao aplicativo.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Esse recurso é de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou uma fonte de dados.
activityType integer Tipo de atividade representado pela sessão.
activeTimeMillis long Tempo de atividade da sessão. Embora start_time_millis e end_time_millis definam o tempo completo da sessão, o tempo de atividade pode ser mais curto e especificado por active_time_millis. Se o tempo de inatividade durante a sessão for conhecido, ele também deverá ser inserido por meio de um ponto de dados com.google.activity.segment com um valor de atividade STILL

Resposta

Se for bem-sucedido, esse método retornará um corpo de resposta com esta estrutura:

{
  "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
}
Nome da propriedade Valor Descrição Observações
id string Um identificador gerado pelo cliente que é exclusivo em todas as sessões desse usuário específico.
name string É um nome legível da sessão.
description string É uma descrição para esta sessão.
startTimeMillis long Um horário de início, em milissegundos desde a época, inclusive.
endTimeMillis long Um horário de término, em milissegundos desde a época, inclusive.
modifiedTimeMillis long Carimbo de data/hora que indica quando a sessão foi modificada pela última vez.
application nested object O aplicativo que criou a sessão.
application.packageName string Nome do pacote para este aplicativo. Ele é usado como um identificador exclusivo quando criado por aplicativos Android, mas não pode ser especificado por clientes REST. Os clientes REST terão o número do projeto do desenvolvedor refletido nos IDs do fluxo de dados da fonte de dados, em vez do packageName.
application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo mudar de modo que afete o cálculo dos dados.
application.detailsUrl string Um URI opcional que pode ser usado para vincular ao aplicativo.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Esse recurso é de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou uma fonte de dados.
activityType integer Tipo de atividade representado pela sessão.
activeTimeMillis long Tempo de atividade da sessão. Embora start_time_millis e end_time_millis definam o tempo completo da sessão, o tempo de atividade pode ser mais curto e especificado por active_time_millis. Se o tempo de inatividade durante a sessão for conhecido, ele também deverá ser inserido por meio de um ponto de dados com.google.activity.segment com um valor de atividade STILL

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.