Comienza a usar la API de REST

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.

  1. Ve a la Consola de API de Google.
  2. Selecciona un proyecto o crea uno nuevo. Usa el mismo proyecto para las versiones de Android y REST de tu app.
  3. Haz clic en Continue para habilitar la Fitness API.
  4. Haz clic en Ir a Credenciales.
  5. Haz clic en Credenciales nuevas y, luego, selecciona ID de cliente de OAuth.
  6. En Tipo de aplicación, selecciona Aplicación web.
  7. 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).
  8. 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).

  9. 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:

  1. Ve a OAuth Playground.
  2. En Paso 1 Selecciona y autoriza APIs, expande Fitness v1 y selecciona los permisos de fitness que quieres usar.
  3. 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.
  4. 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:

  1. En Método HTTP, selecciona GET.
  2. En Request URI (URI de solicitud), ingresa https://www.googleapis.com/fitness/v1/users/me/dataSources.
  3. 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:

  1. En Método HTTP, selecciona POST.
  2. En Request URI (URI de solicitud), ingresa https://www.googleapis.com/fitness/v1/users/me/dataSources.
  3. Haz clic en Ingresar el cuerpo de la solicitud.

  4. 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"
  }
}

  5. En la ventana Cuerpo de la solicitud, haz clic en Cerrar.

  6. 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: