En este instructivo, se muestra cómo activar el acceso a la API de REST de Fitness, obtener tokens de acceso de OAuth e invocar los métodos de la API mediante solicitudes HTTP.
Para usar la API de REST de Fitness, es importante que comprendas los conceptos básicos de los servicios web RESTful y de las representaciones JSON.
Crea una Cuenta de Google
Para usar la API de REST de Fitness, necesitas una Cuenta de Google. Si ya tienes una cuenta, no tienes que hacer nada más. También puedes crear una Cuenta de Google aparte para realizar pruebas.
Cómo solicitar un ID de cliente de OAuth 2.0
Sigue estos pasos para solicitar un ID de cliente de OAuth 2.0 para la API de Fitness.
- Ve a la Consola de API de Google.
- Selecciona un proyecto o crea uno nuevo. Usa el mismo proyecto para las versiones de Android y REST de tu app.
- Haz clic en Continue para habilitar la Fitness API.
- Haz clic en Ir a Credenciales.
- Haz clic en Credenciales nuevas y, luego, selecciona ID de cliente de OAuth.
- En Tipo de aplicación, selecciona Aplicación web.
- En Orígenes autorizados de JavaScript, ingresa la URL base del sitio desde el que se originarán las solicitudes (por ejemplo,
https://developers.google.com
es la URL que usa OAuth Playground). - En URI de redireccionamiento autorizado, ingresa la URL del sitio en el que se controlarán las respuestas (por ejemplo,
https://developers.google.com/oauthplayground
es la URL que usa OAuth Playground). Haz clic en Crear. Tu ID y secreto de cliente de OAuth 2.0 nuevos aparecen en la lista de IDs de tu proyecto. Un ID de cliente de OAuth 2.0 es una cadena de caracteres similar a lo siguiente:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com
Prueba la API de REST en OAuth Playground
El Playground de OAuth es la forma más fácil de familiarizarte con la API de REST de Fitness mediante el envío de solicitudes HTTP y la observación de las respuestas antes de escribir código de cliente.
Sigue estos pasos para autorizar la API de REST de Fitness en OAuth Playground:
- Ve a OAuth Playground.
- En Paso 1 Selecciona y autoriza APIs, expande Fitness v1 y selecciona los permisos de fitness que quieres usar.
- Haz clic en el botón Authorize APIs, selecciona el proyecto de la Consola de APIs de Google que deseas usar y haz clic en Allow cuando se te solicite. Podrás acceder y modificar los datos asociados con la cuenta seleccionada de la Consola de APIs de Google.
- Haz clic en el botón Intercambiar código de autorización para tokens. OAuth Playground incluye automáticamente este encabezado en el encabezado de la solicitud
Authorization:
cuando envías solicitudes HTTP. Ten en cuenta que el token de acceso vencerá después de 60 minutos (3,600 segundos).
Envía solicitudes HTTP
En los siguientes ejemplos, se muestra cómo enviar solicitudes HTTP para enumerar todas las fuentes de datos disponibles y crear una nueva. Para la API de REST de Fitness, el formato de URI es el siguiente:
https://www.googleapis.com/fitness/v1/resourcePath?parameters
Para enumerar todas las fuentes de datos disponibles, haz lo siguiente:
- En Método HTTP, selecciona GET.
- En Request URI (URI de solicitud), ingresa
https://www.googleapis.com/fitness/v1/users/me/dataSources
. - Haz clic en Enviar solicitud.
La solicitud y la respuesta aparecen en el lado derecho de la página. Si la solicitud es exitosa, la respuesta muestra la fuente de datos del ejemplo anterior en formato JSON.
Para crear una fuente de datos, haz lo siguiente:
- En Método HTTP, selecciona POST.
- En Request URI (URI de solicitud), ingresa
https://www.googleapis.com/fitness/v1/users/me/dataSources
. - Haz clic en Ingresar el cuerpo de la solicitud.
En la ventana Cuerpo de la solicitud, copia y pega el siguiente JSON:
{ "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "1" } }
En la ventana Cuerpo de la solicitud, haz clic en Cerrar.
Haz clic en Enviar solicitud.
La solicitud y la respuesta aparecen en el lado derecho de la página. La solicitud incluye el token de acceso de OAuth en el encabezado Authorization
:
Authorization: Bearer ya29.OAuthTokenValue
Si la solicitud se realiza de forma correcta, la primera línea de la respuesta será la siguiente:
HTTP/1.1 200 OK
Usa cURL para acceder a la API de REST de Fit
Puedes usar la herramienta de línea de comandos cURL para acceder a la API de REST de Fit. Necesitarás un token de acceso de OAuth para realizar solicitudes con cURL (consulta las instructions anteriores). Ten en cuenta que los tokens de acceso vencen después de una hora. En el siguiente ejemplo, se muestra una secuencia de comandos bash simple para enumerar todas las fuentes de datos.
#!/bin/bash ACCESS_TOKEN="" curl \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ https://www.googleapis.com/fitness/v1/users/me/dataSources
Próximos pasos
Para obtener más información sobre la API de REST, consulta estas páginas: