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 APIs de Google.
  2. Selecciona un proyecto o crea uno nuevo. Usa el mismo proyecto para Android y las versiones 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 Nuevas credenciales 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 OAuth 2.0 es una cadena de caracteres, algo como esto:

    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 familiarizarte con el Fitness REST API enviando solicitudes HTTP y observando las respuestas antes escribes cualquier código cliente.

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

  1. Ve al Playground de OAuth.
  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 Authorize APIs y selecciona el proyecto de la Consola de APIs de Google para y haz clic en Permitir cuando se te solicite. Podrás acceder y modificar los datos asociados con la cuenta de la Consola de APIs de Google seleccionada.
  4. Haz clic en el botón Intercambiar código de autorización para tokens. El protocolo OAuth Playground incluye automáticamente este encabezado en Authorization: el encabezado de solicitud 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

Los siguientes ejemplos demuestran cómo enviar solicitudes HTTP para enumerar todos fuentes de datos disponibles y crear una nueva fuente de datos. Para la REST de Fitness API, el formato de 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 la solicitud se realiza correctamente, la respuesta muestra la fuente de datos de la 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 tiene éxito, 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 mediante 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 estas páginas: