Users.sessions: list

Lista as sessões criadas anteriormente. Faça o teste agora.

Solicitação

Solicitação HTTP

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

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
userId string Liste as sessões da pessoa identificada. Use me para indicar o usuário autenticado. Somente me é compatível no momento.
Parâmetros de consulta opcionais
activityType integer Se não estiver vazio, apenas as sessões com esses tipos de atividade serão retornadas.
endTime string Um carimbo de data/hora RFC3339. Somente as sessões que terminam entre os horários de início e término serão incluídas na resposta. Se esse horário for omitido, mas startTime for especificado, todas as sessões de startTime até o fim do período serão retornadas.
includeDeleted boolean Se for verdadeiro e se startTime e endTime forem omitidos, as exclusões de sessões serão retornadas.
pageToken string O token de continuação, que é usado para sincronização incremental. Para acessar o próximo lote de mudanças, defina esse parâmetro como o valor de nextPageToken da resposta anterior. O token da página será ignorado se o horário de início ou de término for especificado. Se nenhum do horário de início, o horário de término e o token da página for especificado, as sessões modificadas nos últimos 30 dias serão retornadas.
startTime string Um carimbo de data/hora RFC3339. Somente as sessões que terminam entre os horários de início e término serão incluídas na resposta. Se esse tempo for omitido, mas endTime for especificado, todas as sessões do início ao endTime serão retornadas.

Autorização

Esta solicitação requer autorização com pelo menos um dos seguintes escopos:

Escopo
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

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

Corpo da solicitação

Não forneça um corpo de solicitação com este método.

Resposta

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

{
  "session": [
    {
      "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
    }
  ],
  "deletedSession": [
    {
      "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
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
Nome da propriedade Valor Descrição Observações
session[] list Sessões com um horário de término entre startTime e endTime da solicitação.

session[].id string Um identificador gerado pelo cliente que é exclusivo em todas as sessões desse usuário específico.
session[].name string É um nome legível da sessão.
session[].description string É uma descrição para esta sessão.
session[].startTimeMillis long Um horário de início, em milissegundos desde a época, inclusive.
session[].endTimeMillis long Um horário de término, em milissegundos desde a época, inclusive.
session[].modifiedTimeMillis long Carimbo de data/hora que indica quando a sessão foi modificada pela última vez.
session[].application nested object O aplicativo que criou a sessão.
session[].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.
session[].application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo mudar de modo que afete o cálculo dos dados.
session[].application.detailsUrl string Um URI opcional que pode ser usado para vincular ao aplicativo.
session[].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.
session[].activityType integer Tipo de atividade representado pela sessão.
deletedSession[] list Se includeDeleted for definido como verdadeiro na solicitação e startTime e endTime forem omitidos, isso incluirá sessões que foram excluídas desde a última sincronização.
deletedSession[].id string Um identificador gerado pelo cliente que é exclusivo em todas as sessões desse usuário específico.
deletedSession[].name string É um nome legível da sessão.
deletedSession[].description string É uma descrição para esta sessão.
deletedSession[].startTimeMillis long Um horário de início, em milissegundos desde a época, inclusive.
deletedSession[].endTimeMillis long Um horário de término, em milissegundos desde a época, inclusive.
deletedSession[].modifiedTimeMillis long Carimbo de data/hora que indica quando a sessão foi modificada pela última vez.
deletedSession[].application nested object O aplicativo que criou a sessão.
deletedSession[].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.
deletedSession[].application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo mudar de modo que afete o cálculo dos dados.
deletedSession[].application.detailsUrl string Um URI opcional que pode ser usado para vincular ao aplicativo.
deletedSession[].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.
deletedSession[].activityType integer Tipo de atividade representado pela sessão.
nextPageToken string O token de sincronização usado para sincronizar mais alterações. Isso só será informado se startTime e endTime forem omitidos da solicitação.
session[].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

deletedSession[].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

hasMoreData boolean Sinalização que indica que o servidor tem mais dados para transferir. NÃO USE ESTE CAMPO. Ele nunca é preenchido nas respostas do servidor.

Confira!

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