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.