API Reference

Esta referencia de la API está organizada por tipo de recurso. Cada tipo de recurso tiene una o más representaciones de datos y uno o más métodos.

Tipos de recursos

  1. Users.dataSources
  2. Users.dataSources.dataPointChanges
  3. Users.dataSources.datasets
  4. Users.dataset
  5. Users.sessions

Users.dataSources

Para obtener más información sobre los recursos Users.dataSources, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relacionados con https://www.googleapis.com/fitness/v1/users, a menos que se indique lo contrario
crear POST  /userId/dataSources Crea una fuente de datos nueva que sea única en todas las fuentes de datos que pertenecen a este usuario.

Una fuente de datos es una fuente única de datos de sensores. Las fuentes de datos pueden exponer datos sin procesar provenientes de sensores de hardware en dispositivos locales o complementarios. También pueden exponer datos derivados, que se crean mediante la transformación o combinación de otras fuentes de datos. Pueden existir varias fuentes de datos para el mismo tipo de datos. Cada dato que se inserta en la API de Fitness o que se lee desde esta tiene una fuente de datos asociada.

Cada fuente de datos produce una transmisión única de actualizaciones de conjuntos de datos, con un identificador de fuente de datos único. No todos los cambios en la fuente de datos afectan el ID de flujo de datos, por lo que los datos recopilados por las versiones actualizadas de la misma aplicación o dispositivo pueden considerarse que pertenecen a la misma fuente de datos.

Las fuentes de datos se identifican con una string que genera el servidor, en función del contenido de la fuente que se crea. No se debe configurar el campo dataStreamId cuando se invoca este método. El servidor lo generará automáticamente con el formato correcto. Si se configura un dataStreamId, debe coincidir con el formato que generará el servidor. Este formato es una combinación de algunos campos de la fuente de datos y tiene un orden específico. Si no coincide, la solicitud fallará y mostrará un error.

Si especificas un DataType que no es un tipo conocido (que comienza con “com.google.”), se creará una DataSource con un tipo de datos personalizado. Solo la aplicación que creó los tipos de datos personalizados puede leerlos. Los tipos de datos personalizados están obsoletos; en su lugar, usa los tipos de datos estándar.

Además de los campos de fuente de datos incluidos en el ID de la fuente de datos, se incluye el número de proyecto del desarrollador que se autentica cuando se crea la fuente de datos. Este número de proyecto del desarrollador se ofusca cuando lo lee cualquier otro desarrollador que lee tipos de datos públicos.
borrar DELETE  /userId/dataSources/dataSourceId Borra la fuente de datos especificada. La solicitud fallará si la fuente de datos contiene datos.
get GET  /userId/dataSources/dataSourceId Muestra la fuente de datos especificada.
list GET  /userId/dataSources Enumera todas las fuentes de datos que son visibles para el desarrollador, con los permisos de OAuth proporcionados. La lista no es exhaustiva; el usuario puede tener fuentes de datos privadas que solo son visibles para otros desarrolladores, o llamadas que usan otros permisos.
actualizar PUT  /userId/dataSources/dataSourceId Actualiza la fuente de datos especificada. Las propiedades dataStreamId, dataType, type, dataStreamName y device, excepto version, no se pueden modificar.

Las fuentes de datos se identifican por su dataStreamId.

Users.dataSources.dataPointChanges

Para obtener más información sobre los recursos Users.dataSources.dataPointChanges, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relacionados con https://www.googleapis.com/fitness/v1/users, a menos que se indique lo contrario
list GET  /userId/dataSources/dataSourceId/dataPointChanges Consultas de cambios de datos del usuario para una fuente de datos específica

Users.dataSources.datasets

Para obtener más información sobre los recursos Users.dataSources.datasets, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relacionados con https://www.googleapis.com/fitness/v1/users, a menos que se indique lo contrario
borrar DELETE  /userId/dataSources/dataSourceId/datasets/datasetId Realiza una eliminación inclusiva de todos los datos cuyas horas de inicio y finalización se superponen con el intervalo de tiempo especificado por el ID del conjunto de datos. Para la mayoría de los tipos de datos, se borrará todo el dato. Para los tipos de datos en los que el intervalo de tiempo representa un valor coherente (como com.google.activity.segment) y un dato se encuentra en cualquiera de los extremos del conjunto de datos, solo se borrará la parte superpuesta del dato.
get GET  /userId/dataSources/dataSourceId/datasets/datasetId Muestra un conjunto de datos que contiene todos los datos cuyas horas de inicio y finalización se superponen con el rango especificado de la hora de inicio mínima y la hora de finalización máxima del conjunto de datos. Específicamente, cualquier dato cuya hora de inicio es menor o igual que la hora de finalización del conjunto de datos y cuya hora de finalización es mayor o igual que la hora de inicio del conjunto de datos.
patch PATCH  /userId/dataSources/dataSourceId/datasets/datasetId Agrega puntos de datos a un conjunto de datos. No es necesario crear el conjunto de datos con anterioridad. Todos los puntos dentro del conjunto de datos dado se mostrarán con llamadas posteriores para recuperar este conjunto de datos. Los datos pueden pertenecer a más de un conjunto de datos.

Este método no usa semántica de parche: los datos proporcionados simplemente se insertan, sin reemplazar los datos existentes.

Users.dataset

Para obtener más información sobre los recursos Users.dataset, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relacionados con https://www.googleapis.com/fitness/v1/users, a menos que se indique lo contrario
agregar POST  /userId/dataset:aggregate Agrega datos de un cierto tipo o transmisión en buckets divididos por un tipo de límite determinado. Se pueden agregar varios conjuntos de datos de varios tipos y de varias fuentes en exactamente un tipo de bucket por solicitud.

Users.sessions

Para obtener más información sobre los recursos Users.sessions, consulta la página de representación de recursos.

Método Solicitud HTTP Descripción
URI relacionados con https://www.googleapis.com/fitness/v1/users, a menos que se indique lo contrario
borrar DELETE  /userId/sessions/sessionId Borra una sesión especificada por el ID de sesión determinado.
list GET  /userId/sessions Muestra una lista de las sesiones creadas anteriormente.
actualizar PUT  /userId/sessions/sessionId Actualiza o inserta una sesión determinada.