Primeiros passos com a API REST

Neste tutorial, mostramos como ativar o acesso à API REST do Google Fit, receber tokens de acesso do OAuth e invocar os métodos da API usando solicitações HTTP.

Para usar a API REST Fitness, é importante que você entenda os conceitos básicos de Serviços RESTful da Web e representações JSON.

Criar uma Conta do Google

Para usar a API REST Fitness, você precisa de uma Conta do Google. Se você já tem uma conta, então está tudo pronto. Você também pode querer criar outra Conta do Google para fins de teste.

Solicitar um ID do cliente OAuth 2.0

Siga estas etapas para solicitar um ID do cliente OAuth 2.0 para a API Fitness.

  1. Vá para a Console de APIs do Google.
  2. Selecione um projeto ou crie um novo. Usar o mesmo projeto para o Android e versões REST do seu app.
  3. Clique em Continuar para ativar a API Fitness.
  4. Clique em Acessar credenciais.
  5. Clique em Novas credenciais e selecione ID do cliente OAuth.
  6. Em Tipo de aplicativo, selecione Aplicativo da Web.
  7. Em Origens JavaScript autorizadas, insira o URL de base do site de onde as solicitações vão ser originadas. Por exemplo, https://developers.google.com é o URL usado pelo OAuth Playground.
  8. Em URI de redirecionamento autorizado, digite o URL do site em que as respostas serão processados (por exemplo, https://developers.google.com/oauthplayground é o URL usado pelo OAuth Playground).

  9. Clique em Criar. Seu novo ID do cliente OAuth 2.0 e sua chave secreta aparecem na lista de IDs para seu projeto. Um ID do cliente OAuth 2.0 é uma string de caracteres, como esta:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Testar a API REST no Playground do OAuth

O OAuth Playground é a forma mais fácil de se familiarizar com os a API REST Fitness enviando solicitações HTTP e observando as respostas antes de você escreve qualquer código cliente.

Para autorizar a API REST Fitness no OAuth Playground:

  1. Acesse o OAuth Playground.
  2. Na etapa 1, selecione e autorizar APIs, expanda Fitness v1 e selecione os escopos de condicionamento físico a serem usados.
  3. Clique no botão Authorize APIs, selecione o projeto do Console de APIs do Google que você quer usar e clique em Allow quando solicitado. Você poderá acessar e modificar os dados associados à conta selecionada do Console de APIs do Google.
  4. Clique no botão Trocar código de autorização por tokens. O OAuth Playground inclui automaticamente esse cabeçalho no cabeçalho de solicitação Authorization: quando você envia solicitações HTTP. O token de acesso vai expirar após 60 minutos (3.600 segundos).

Enviar solicitações HTTP

Os exemplos a seguir demonstram como enviar solicitações HTTP para listar todas as fontes de dados disponíveis e criar uma nova. Para o REST de condicionamento físico API, o formato do URI será:

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

Para listar todas as fontes de dados disponíveis:

  1. Em Método HTTP, selecione GET.
  2. Em URI da solicitação, insira https://www.googleapis.com/fitness/v1/users/me/dataSources.
  3. Clique em Send the request.

A solicitação e a resposta aparecem no lado direito da página. Se a solicitação for bem-sucedida, a resposta vai mostrar a fonte de dados do exemplo anterior no formato JSON.

Para criar uma fonte de dados:

  1. Em Método HTTP, selecione POST.
  2. Em URI de solicitação, insira https://www.googleapis.com/fitness/v1/users/me/dataSources.
  3. Clique em Inserir corpo da solicitação.

  4. Na janela Corpo da solicitação, copie e cole o seguinte 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. Na janela Corpo da solicitação, clique em Fechar.

  6. Clique em Enviar a solicitação.

A solicitação e a resposta aparecem no lado direito da página. A solicitação inclui o token de acesso OAuth no cabeçalho Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Se a solicitação for bem-sucedida, a primeira linha da resposta será:

HTTP/1.1 200 OK

Usar cURL para acessar a API REST do Fit

Use a ferramenta de linha de comando cURL para acessar a API REST do Fit. Você vai precisar de um token de acesso OAuth para fazer solicitações usando a cURL (consulte as instruções anteriores). Os tokens de acesso expiram após uma hora. O exemplo a seguir mostra um script bash simples para listar todas as fontes de dados.

#!/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óximas etapas

Para saber mais sobre a API REST, consulte estas páginas: