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.
- Acesse o Console de APIs do Google.
- Selecione um projeto ou crie um novo. Use o mesmo projeto para as versões Android e REST do app.
- Clique em Continuar para ativar a API Fitness.
- Clique em Acessar credenciais.
- Clique em Novas credenciais e selecione ID do cliente OAuth.
- Em Tipo de aplicativo, selecione Aplicativo da Web.
- 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. - 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. 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:
- Acesse o OAuth Playground.
- Em Etapa 1: selecionar e autorizar APIs, expanda Fitness v1 e selecione os escopos de condicionamento físico que serão usados.
- 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.
- 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:
- Em Método HTTP, selecione GET.
- Em Solicitar URI, insira
https://www.googleapis.com/fitness/v1/users/me/dataSources
- 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:
- Em Método HTTP, selecione POST.
- Em Solicitar URI, insira
https://www.googleapis.com/fitness/v1/users/me/dataSources
- Clique em Inserir corpo da solicitação.
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" } }
Na janela Corpo da solicitação, clique em Fechar.
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: