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
Usuarios.fuentesdedatos
Para obtener detalles sobre el recurso 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 es única entre 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, creados mediante la transformación o combinación de otras fuentes de datos. Puede haber varias fuentes de datos para el mismo tipo de datos. Cada dato en cada conjunto de datos insertado en la API de Fitness o leído en ella tiene una fuente de datos asociada. Cada fuente de datos produce un flujo único 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 del mismo dispositivo o aplicación se pueden considerar que pertenecen a la misma fuente de datos. Las fuentes de datos se identifican mediante una string generada por el servidor, que se basa en el contenido de la fuente que se crea. No se debe establecer 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 se especifica un DataType que no es un tipo conocido (comienza con &comt;com.google."), se creará un DataSource con un tipo de datos personalizado. Solo la aplicación que los creó puede leer los tipos de datos personalizados. Los tipos de datos personalizados están obsoletos; en su lugar, usa tipos de datos estándar. Además de los campos de la fuente de datos incluidos en el ID de la fuente de datos, se incluye el número del proyecto de desarrollador que se autentica cuando se crea la fuente de datos. Este número de proyecto de desarrollador se ofusca cuando lo lee cualquier otro desarrollador que lea 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. |
| obtener |
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 alcances 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 alcances. |
| actualizar |
PUT /userId/dataSources/dataSourceId
|
Actualiza la fuente de datos especificada. Las propiedades dataStreamId, dataType, type, dataStreamName y device, a excepción de version, no se pueden modificar.
Las fuentes de datos se identifican por su dataStreamId.
|
Users.dataSources.dataPointChanges
Para obtener más información sobre recursos de usuarios.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
|
Las consultas sobre los datos de un usuario cambian para una fuente de datos en particular. |
Users.dataSources.datasets
Para obtener detalles sobre el recurso 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 tengan alguna superposición 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 período representa un valor coherente (como com.google.activity.segment) y un dato se extiende a cualquiera de los extremos del conjunto de datos, solo se borrará la parte superpuesta del dato.
|
| obtener |
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 y la hora de finalización máximas del conjunto de datos. En particular, cualquier dato cuya hora de inicio sea menor o igual que la hora de finalización del conjunto de datos y cuya hora de finalización sea mayor o igual que la hora de inicio del conjunto de datos. |
| parche |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
Agrega datos a un conjunto de datos. No es necesario crear el conjunto de datos con anterioridad.
Todos los puntos dentro del conjunto de datos determinado 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 la semántica de parches: los datos proporcionados solo se insertan y no se reemplazan los datos existentes. |
Usuarios.conjunto de datos
Para obtener más información sobre los recursos Resource.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 | ||
| agregado |
POST /userId/dataset:aggregate
|
Agrega datos de un tipo determinado o una transmisión a depósitos divididos por un tipo de límite determinado. Se pueden agregar varios conjuntos de datos de varios tipos y de varias fuentes en un solo tipo de bucket por solicitud. |
Users.sessions
Para obtener detalles sobre el recurso 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 dado. |
| list |
GET /userId/sessions
|
Enumera las sesiones creadas anteriormente. |
| actualizar |
PUT /userId/sessions/sessionId
|
Actualiza o inserta una sesión determinada. |