Comienza a usar la API de REST

En este instructivo, se muestra cómo activar el acceso a la API de REST de Fitness y obtener acceso a OAuth tokens e invocar los métodos de la API con solicitudes HTTP.

Para usar la API de REST de Fitness, es importante que comprendas los conceptos básicos de 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. También puedes crear otra Cuenta de Google 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 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. en la 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 generan las respuestas. (por ejemplo, https://developers.google.com/oauthplayground es la URL que usa OAuth Playground).

  9. Haz clic en Crear. Tu nuevo ID y secreto de cliente de OAuth 2.0 aparecen en la lista de IDs para tu proyecto. Un ID de cliente de OAuth 2.0 es una cadena de caracteres, similar a la siguiente:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Prueba la API de REST en el Playground de OAuth

OAuth Playground es la forma más fácil de familiarizarse con la API de Fitness REST. Para ello, envía solicitudes HTTP y observa las respuestas antes de escribir cualquier código de cliente.

Para autorizar la API de REST de Fitness en el Playground de OAuth:

  1. Ve a OAuth Playground.
  2. En el Paso 1, selecciona y autorizar APIs, expande Fitness v1 y selecciona los alcances de Fitness que se deben usar.
  3. Haz clic en el botón Autorizar APIs, selecciona el proyecto de la Consola de APIs de Google que deseas usar y haz clic en Permitir cuando se te solicite. Podrás acceder a los datos asociados con la cuenta de la Consola de API de Google seleccionada y modificarlos.
  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 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 Fitness REST, el formato del URI es el siguiente:

https://www.googleapis.com/fitness/v1/resourcePath?parameters

Para enumerar todas las fuentes de datos disponibles, sigue estos pasos:

  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 la solicitud.

La solicitud y la respuesta aparecen en el lado derecho de la página. Si el botón exitosa, la respuesta muestra la fuente de datos de la respuesta ejemplo en formato JSON.

Para crear una fuente de datos, haz lo siguiente:

  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 la 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 correctamente, 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 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 un 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: