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
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.datasets
- Users.dataset
- 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. |