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 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 horário serão retornadas.
includeDeleted boolean Se for verdadeiro e se startTime e endTime forem omitidos, as exclusões da sessão serão retornadas.
pageToken string O token de continuação, usado para sincronização incremental. Para acessar o próximo lote de alterações, defina esse parâmetro como o valor de nextPageToken da resposta anterior. O token de página será ignorado se o horário de início ou de término for especificado. Se nenhum horário de início e de término e o token de página forem especificados, 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 horário for omitido, mas endTime for especificado, todas as sessões desde o início até 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 do usuário em questão.
session[].name string Um nome legível para a sessão.
session[].description string Uma descrição da 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 Um 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 de desenvolvedor refletido nos IDs de 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 forma que afete o cálculo dos dados.
session[].application.detailsUrl string Um URI opcional que pode ser usado para vincular-se de volta ao aplicativo.
session[].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.
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 vai 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 do usuário em questão.
deletedSession[].name string Um nome legível para a sessão.
deletedSession[].description string Uma descrição da 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 Um 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 de desenvolvedor refletido nos IDs de 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 forma que afete o cálculo dos dados.
deletedSession[].application.detailsUrl string Um URI opcional que pode ser usado para vincular-se de volta ao aplicativo.
deletedSession[].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.
deletedSession[].activityType integer O tipo de atividade que esta sessão representa.
nextPageToken string O token de sincronização que é usado para sincronizar outras alterações. Ele só 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 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

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 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

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.