Esta referência da API está organizada por tipo de recurso. Cada tipo de recurso tem uma ou mais representações de dados e um ou mais métodos.
Tipos de recurso
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.datasets
- Users.dataset
- Users.sessions
Users.dataSources
Para detalhes do recurso Users.dataSources, consulte a página de representação do recurso.
| Método | Solicitação HTTP | Descrição |
|---|---|---|
| URIs relacionados a https://www.googleapis.com/fitness/v1/users, a menos que especificado de outra forma | ||
| create |
POST /userId/dataSources
|
Cria uma nova fonte de dados exclusiva em todas as fontes de dados deste usuário.
Uma fonte de dados é uma fonte única de dados do sensor. As fontes de dados podem expor dados brutos provenientes de sensores de hardware em dispositivos locais ou complementares. Eles também podem expor dados derivados, criados ao transformar ou mesclar outras fontes de dados. Várias fontes de dados podem existir para o mesmo tipo de dados. Cada ponto de dados em cada conjunto de dados inserido ou lido da API Fitness tem uma fonte de dados associada. Cada fonte de dados produz um stream exclusivo de atualizações de conjuntos de dados, com um identificador exclusivo. Nem todas as mudanças na fonte de dados afetam o ID do fluxo. Assim, os dados coletados por versões atualizadas do mesmo aplicativo/dispositivo ainda poderão ser considerados pertencentes à mesma fonte de dados. As origens de dados são identificadas usando uma string gerada pelo servidor com base no conteúdo da origem que está sendo criada. O campo dataStreamId
não pode ser definido ao invocar esse método. Ele
será gerado automaticamente pelo servidor com o formato correto. Se
um dataStreamId for definido, ele precisará corresponder ao formato
gerado pelo servidor. Esse formato é uma combinação de alguns campos da
fonte de dados e tem uma ordem específica. Se não corresponder, a solicitação
falhará com um erro.
Especificar um DataType que não é um tipo conhecido (começando com "com.google.") criará um DataSource com um tipo de dados personalizado. Os tipos de dados personalizados só podem ser lidos pelo aplicativo que os criou. Os tipos de dados personalizados foram descontinuados. Em vez disso, use tipos de dados padrão. Além dos campos da fonte de dados incluídos no ID da fonte de dados, o número do projeto do desenvolvedor que é autenticado ao criar a fonte de dados é incluído. Esse número do projeto de desenvolvedor é ofuscado quando lido por outros desenvolvedores que leem tipos de dados públicos. |
| delete |
DELETE /userId/dataSources/dataSourceId
|
Exclui a fonte de dados especificada. A solicitação falhará se a fonte de dados contiver pontos de dados. |
| get |
GET /userId/dataSources/dataSourceId
|
Retorna a fonte de dados especificada. |
| list |
GET /userId/dataSources
|
Lista todas as fontes de dados visíveis para o desenvolvedor usando os escopos do OAuth fornecidos. Essa lista não está completa. O usuário pode ter fontes de dados particulares visíveis somente para outros desenvolvedores ou chamadas usando outros escopos. |
| update |
PUT /userId/dataSources/dataSourceId
|
Atualiza a fonte de dados especificada. As propriedades
dataStreamId, dataType, type, dataStreamName e
device, exceto version,
não podem ser modificadas.
As fontes de dados são identificadas pela dataStreamId.
|
Users.dataSources.dataPointChanges
Para detalhes do recurso Users.dataSources.dataPointChanges, consulte a página Representação de recursos.
| Método | Solicitação HTTP | Descrição |
|---|---|---|
| URIs relacionados a https://www.googleapis.com/fitness/v1/users, a menos que especificado de outra forma | ||
| list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
Consultas para pontos de dados do usuário mudam para uma fonte de dados específica. |
Users.dataSources.datasets
Para detalhes do recurso Users.dataSources.datasets, consulte a página de representação do recurso.
| Método | Solicitação HTTP | Descrição |
|---|---|---|
| URIs relacionados a https://www.googleapis.com/fitness/v1/users, a menos que especificado de outra forma | ||
| delete |
DELETE /userId/dataSources/dataSourceId/datasets/datasetId
|
Executa uma exclusão inclusiva de todos os pontos de dados com horários de início e término
que se sobrepõem ao período especificado pelo ID do conjunto de dados. Para a maioria dos tipos de dados, o ponto de dados inteiro será excluído. Para tipos de dados em que o período representa um valor consistente (como com.google.activity.segment) e um ponto de dados abrange qualquer ponto final do conjunto de dados, apenas a parte sobreposta do ponto de dados é excluída.
|
| get |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
Retorna um conjunto de dados que contém todos os pontos de dados cujos horários de início e término se sobrepõem ao intervalo especificado dos tempos mínimo e máximo de início do conjunto de dados. Especificamente, qualquer ponto de dados cujo horário de início seja menor ou igual ao horário de término do conjunto de dados e que tenha um horário de término maior ou igual ao horário de início do conjunto de dados. |
| patch |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
Adiciona pontos de dados a um conjunto de dados. O conjunto de dados não precisa ser criado anteriormente.
Todos os pontos do conjunto de dados específico serão retornados com chamadas subsequentes
para recuperar esse conjunto de dados. Os pontos de dados podem pertencer a mais de um conjunto de dados.
Esse método não usa semântica de patches: os pontos de dados fornecidos são meramente inseridos, sem dados existentes substituídos. |
Usuários.conjunto de dados
Para detalhes sobre Users.dataset, consulte a página de representação do recurso.
| Método | Solicitação HTTP | Descrição |
|---|---|---|
| URIs relacionados a https://www.googleapis.com/fitness/v1/users, a menos que especificado de outra forma | ||
| agregados |
POST /userId/dataset:aggregate
|
Agrega dados de um determinado tipo ou stream em buckets divididos por um determinado tipo de limite. Vários conjuntos de dados de vários tipos e de várias fontes podem ser agregados em exatamente um tipo de bucket por solicitação. |
Usuários.sessões
Para detalhes do recurso "Users.sessions", consulte a página representação de recursos.
| Método | Solicitação HTTP | Descrição |
|---|---|---|
| URIs relacionados a https://www.googleapis.com/fitness/v1/users, a menos que especificado de outra forma | ||
| delete |
DELETE /userId/sessions/sessionId
|
Exclui uma sessão especificada pelo ID de sessão especificado. |
| list |
GET /userId/sessions
|
Lista as sessões criadas anteriormente. |
| update |
PUT /userId/sessions/sessionId
|
Atualiza ou insere uma determinada sessão. |