Vamos começar com a API REST

Neste tutorial, você vai ver como ativar o acesso à API REST do Google Fitness, conseguir tokens de acesso OAuth e invocar os métodos da API usando solicitações HTTP.

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

Criar uma Conta do Google

Para usar a API REST do Google 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 do OAuth 2.0

Siga estas etapas para solicitar um ID do cliente do 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 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 manipuladas. Por exemplo, https://developers.google.com/oauthplayground é o URL usado pelo Playground OAuth.
  9. Clique em Criar. O novo ID do cliente e a chave secreta do OAuth 2.0 aparecem na lista de IDs do seu projeto. Um ID do cliente OAuth 2.0 é uma string de caracteres, algo parecido com isto:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Teste a API REST no Playground OAuth

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

Para autorizar a API REST do Fitness no Playground OAuth:

  1. Acesse o OAuth Playground.
  2. Em Etapa 1: selecionar & API de autorização, expanda Condicionamento físico v1 e selecione os escopos de condicionamento físico a serem 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. Você poderá acessar e modificar os dados associados à conta do Console de APIs do Google selecionada.
  4. Clique no botão Trocar código de autorização dos 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 expira após 60 minutos (3.600 segundos).

Enviar solicitações HTTP

Nos exemplos a seguir, você vê como enviar solicitações HTTP para listar todas as fontes de dados disponíveis e criar uma nova. Para a API REST REST, 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 mostrará a fonte de dados do exemplo anterior no formato JSON.

Para criar uma fonte de dados, faça o seguinte:

  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 Fit. Você precisará de um token de acesso OAuth para fazer solicitações usando cURL. Consulte as instruções anteriores. Observe que 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: