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 y, también, 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 de RESTful y 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. Es posible que también desees crear una Cuenta de Google independiente para realizar pruebas.

Solicita un ID de cliente de OAuth 2.0

Siga 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 Continuar para habilitar la API de Fitness.
  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 el Playground de OAuth).
  8. En URI de redireccionamiento autorizado, ingresa la URL del sitio en el que se manejarán las respuestas (por ejemplo, https://developers.google.com/oauthplayground es la URL que usa el Playground de OAuth).

  9. Haga clic en Crear. Tu ID de cliente y tu secreto de OAuth 2.0 nuevos aparecen en la lista de ID de tu proyecto. Un ID de cliente de OAuth 2.0 es una string de caracteres similar a esta:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Prueba la API de REST en el Playground de OAuth

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 cualquier código de cliente.

Para autorizar la API de REST de Fitness en el Playground de OAuth, haz lo siguiente:

  1. Ve a la zona de pruebas de OAuth.
  2. En Paso 1: Seleccionar &autorizar API, expande Fitness v1 y selecciona los permisos de entrenamiento que deseas usar.
  3. Haz clic en el botón Autorizar API, selecciona el proyecto de la Consola de API de Google que deseas usar y haz clic en Permitir cuando se te solicite. Podrás acceder y modificar los datos asociados a la cuenta seleccionada de la Consola de API de Google.
  4. Haga 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).

Enviar solicitudes HTTP

En los siguientes ejemplos, se muestra cómo enviar solicitudes HTTP para enumerar todas las fuentes de datos disponibles y crear una fuente de datos 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 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, sigue estos pasos:

  1. En Método HTTP, selecciona POST.
  2. En URI de solicitud, ingresa https://www.googleapis.com/fitness/v1/users/me/dataSources.
  3. Haz clic en Ingresar 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 es exitosa, la primera línea de la respuesta es 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 de 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 instrucciones 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 las siguientes páginas: