Primeiros passos com a API REST

Neste tutorial, mostramos como ativar o acesso à API REST Fitness, receber tokens de acesso 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 dos serviços RESTful da Web e das 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. Também é possível criar uma Conta do Google separada 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. Acesse o Console de APIs do Google.
  2. Selecione um projeto ou crie um novo. Use o mesmo projeto para as versões Android e REST do 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 origem das solicitações. Por exemplo, https://developers.google.com é o URL usado pelo Playground OAuth.
  8. Em URI de redirecionamento autorizado, insira o URL do site em que as respostas serão processadas. Por exemplo, https://developers.google.com/oauthplayground é o URL usado pelo Playground OAuth.

  9. Clique em Criar. O novo ID do cliente OAuth 2.0 e a chave secreta aparecem na lista de IDs do projeto. Um ID do cliente OAuth 2.0 é uma string de caracteres semelhante a esta:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Teste a API REST no OAuth Playground

O OAuth Playground é a maneira mais fácil de se familiarizar com a API REST do Google Fitness enviando solicitações HTTP e observando as respostas antes de escrever qualquer código de cliente.

Para autorizar a API REST de condicionamento físico no OAuth Playground, faça o seguinte:

  1. Acesse o OAuth Playground.
  2. Em Etapa 1: selecionar e autorizar APIs, expanda Fitness v1 e selecione os escopos de condicionamento físico que serão usados.
  3. Clique no botão Autorizar APIs, selecione o projeto do Console de APIs do Google a ser usado e clique em Permitir quando solicitado. Será possível acessar e modificar os dados associados à conta selecionada do Console de APIs do Google.
  4. Clique no botão Exchange Authorization code for tokens. O OAuth Playground inclui automaticamente esse cabeçalho no cabeçalho da solicitação Authorization: quando você envia solicitações HTTP. O token de acesso expira em 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 fonte. Para a API REST de condicionamento físico, o formato do URI é:

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 Solicitar URI, 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 Solicitar URI, 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 Send the request.

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 cURL. Consulte as instructions 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: