Primeiros passos com a API REST

Este tutorial mostra como ativar o acesso à API REST Fitness e receber acesso de OAuth e invocam 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 o 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, digite o URL de base do site. origem das solicitações (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, algo assim:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Testar a API REST no OAuth Playground

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 Autorizar APIs e selecione o projeto do Console de APIs do Google para usar e clique em Permitir 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 O Playground inclui automaticamente esse cabeçalho no Authorization: ao enviar solicitações HTTP. O token de acesso vai expirar depois de 60 minutos (3.600 segundos).

Enviar solicitações HTTP

Os exemplos a seguir demonstram como enviar solicitações HTTP para listar todos 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 de 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 o solicitação for bem-sucedida, a resposta mostrará a fonte de dados da exemplo 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 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 as a API REST do Fit. Você precisará de um token de acesso OAuth para fazer solicitações Use 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: