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 O ID da sessão a ser criada.
userId string Criar 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 do usuário em questão.
name string Um nome legível para a sessão.
description string Uma descrição da 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 Um 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 de desenvolvedor refletido nos IDs de 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 forma que afete o cálculo dos dados.
application.detailsUrl string Um URI opcional que pode ser usado para vincular-se de volta ao aplicativo.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que gostariam de identificar qual REST criou um aplicativo ou uma fonte de dados.
activityType integer O tipo de atividade que esta sessão representa.
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 ativo pode ser mais curto e especificado por "active_time_millis". Se o tempo inativo durante a sessão for conhecido, ele também precisa ser inserido por um ponto de dados com.google.activity.segment com um valor de atividade AINDA

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 do usuário em questão.
name string Um nome legível para a sessão.
description string Uma descrição da 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 Um 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 de desenvolvedor refletido nos IDs de 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 forma que afete o cálculo dos dados.
application.detailsUrl string Um URI opcional que pode ser usado para vincular-se de volta ao aplicativo.
application.name string O nome deste aplicativo. Isso é necessário para clientes REST, mas não aplicamos exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que gostariam de identificar qual REST criou um aplicativo ou uma fonte de dados.
activityType integer O tipo de atividade que esta sessão representa.
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 ativo pode ser mais curto e especificado por "active_time_millis". Se o tempo inativo durante a sessão for conhecido, ele também precisa ser inserido por um ponto de dados com.google.activity.segment com um valor de atividade AINDA

Confira!

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