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, somente sessões com esses tipos de atividade deverão ser 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 em a resposta. Se esse horário for omitido, mas startTime for especificado, todas as sessões de startTime até o fim do horário serão retornadas.
includeDeleted boolean Se verdadeiro, e se startTime e endTime forem omitidos, as exclusões de sessão serão retornadas.
pageToken string O token de continuação, usado para sincronização incremental. Para obter o próximo lote de alterações, defina esse parâmetro para 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 não for o horário de início, de término e o token da página for especificado, as sessões modificadas no 30 dias serão devolvidos.
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 em a resposta. Se esse horário for omitido, mas endTime for especificado, todas as sessões, desde o início até endTime, serão retornados.

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.
de
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 da sessão.
session[].startTimeMillis long Um horário de início, em milissegundos desde o período, inclusive.
session[].endTimeMillis long Um horário de término, em milissegundos desde o período, 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 deste 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, e não no packageName.
session[].application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo for alterado de maneira que afete a computação dos dados.
session[].application.detailsUrl string Um URI opcional que pode ser usado para vincular de volta ao aplicativo.
session[].application.name string O nome deste aplicativo. Isso é obrigatório para clientes REST, mas não aplicamos a exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou fonte de dados.
session[].activityType integer O tipo de atividade que esta sessão representa.
deletedSession[] list Se includeDeleted for definido como verdadeiro na solicitação e startTime e endTime forem omitidos, isso incluirá as sessões 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 da sessão.
deletedSession[].startTimeMillis long Um horário de início, em milissegundos desde o período, inclusive.
deletedSession[].endTimeMillis long Um horário de término, em milissegundos desde o período, 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 deste 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, e não no packageName.
deletedSession[].application.version string Versão do aplicativo. Atualize esse campo sempre que o aplicativo for alterado de maneira que afete a computação dos dados.
deletedSession[].application.detailsUrl string Um URI opcional que pode ser usado para vincular de volta ao aplicativo.
deletedSession[].application.name string O nome deste aplicativo. Isso é obrigatório para clientes REST, mas não aplicamos a exclusividade desse nome. Ele é fornecido como uma questão de conveniência para outros desenvolvedores que querem identificar qual REST criou um aplicativo ou fonte de dados.
deletedSession[].activityType integer O tipo de atividade que esta sessão representa.
nextPageToken string O token de sincronização usado para sincronizar outras alterações. Isso só vai ser fornecido 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 ativo pode ser menor e especificado por "active_time_millis". Se o tempo inativo durante a sessão for conhecido, ele também precisará ser inserido por 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 ativo pode ser menor e especificado por "active_time_millis". Se o tempo inativo durante a sessão for conhecido, ele também precisará ser inserido por 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.