As APIs do Google Fit, incluindo a API REST do Google Fit, serão descontinuadas em 2026. A partir de 1º de maio de 2024, os desenvolvedores não poderão se inscrever para usar essas APIs.
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.
Selecione um projeto ou crie um novo. Usar o mesmo projeto para o Android
e versões REST do seu 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, digite o URL de base do site.
origem das solicitações (por exemplo, https://developers.google.com
é o URL usado pelo OAuth Playground).
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).
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:
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:
Na etapa 1, selecione e autorizar APIs, expanda Fitness v1 e selecione
os escopos de condicionamento físico a serem usados.
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.
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á:
Em URI de solicitação, 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 o
solicitação for bem-sucedida, a resposta mostrará a fonte de dados da
exemplo no formato JSON.
Para criar uma fonte de dados:
Em Método HTTP, selecione POST.
Em URI de solicitação, 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 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThis tutorial provides a comprehensive guide on activating and utilizing the Fitness REST API for accessing and managing fitness data.\u003c/p\u003e\n"],["\u003cp\u003eIt outlines the process of obtaining OAuth access tokens for authentication and authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou will learn how to make HTTP requests to interact with the API, including listing data sources and creating new ones.\u003c/p\u003e\n"],["\u003cp\u003eThe tutorial also provides practical examples using the OAuth Playground and cURL for testing and implementation.\u003c/p\u003e\n"],["\u003cp\u003eIt includes links to further resources for in-depth understanding of data types, sessions, and workout recording.\u003c/p\u003e\n"]]],[],null,["# Getting Started with the REST API\n\nThis tutorial shows you how to activate access to the Fitness REST API, obtain OAuth access\ntokens, and invoke the API methods using HTTP requests.\n\nTo use the Fitness REST API, it is important that you understand the basics of\n[RESTful web services](http://en.wikipedia.org/wiki/Representational_state_transfer#Applied_to_web_services)\nand [JSON representations](http://en.wikipedia.org/wiki/JSON).\n\nGet a Google Account\n--------------------\n\nTo use the Fitness REST API, you need a [Google Account](https://www.google.com/accounts/NewAccount).\nIf you already have an account, then you're all set. You may also want to\ncreate a separate Google Account for testing purposes.\n\nRequest an OAuth 2.0 client ID\n------------------------------\n\nFollow these steps to request an OAuth 2.0 client ID for the Fitness API.\n\n1. Go to the [Google API Console](https://console.cloud.google.com/flows/enableapi?apiid=fitness).\n2. Select a project, or create a new one. Use the same project for the Android and REST versions of your app.\n3. Click **Continue** to enable the Fitness API.\n4. Click **Go to credentials**.\n5. Click **New credentials** , then select **OAuth Client ID**.\n6. Under **Application type** , select **Web application**.\n7. Under **Authorized JavaScript origins** , enter the base URL of the site from which requests will originate (for example `https://developers.google.com` is the URL used by the OAuth Playground).\n8. Under **Authorized redirect URI** , enter the URL of the site where responses will be handled (for example `https://developers.google.com/oauthplayground` is the URL used by the OAuth Playground).\n9. Click **Create**. Your new OAuth 2.0 Client ID and secret appear in the list\n of IDs for your project. An OAuth 2.0 Client ID is a string of characters,\n something like this:\n\n `780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com`\n\nTry the REST API in the OAuth Playground\n----------------------------------------\n\nThe OAuth Playground is the easiest way to familiarize yourself with the\nFitness REST API by submitting HTTP requests and observing the responses before\nyou write any client code.\n\nTo authorize the Fitness REST API in the OAuth Playground:\n\n1. Go to the [OAuth Playground](https://developers.google.com/oauthplayground/).\n2. Under **Step 1 Select \\& authorize APIs** , expand **Fitness v1** and select the Fitness scopes to use.\n3. Click the **Authorize APIs** button, select the Google API Console project to use, and click **Allow** when prompted. You will be able to access and modify data associated with the selected Google API Console account.\n4. Click the **Exchange authorization code for tokens** button. The OAuth Playground automatically includes this header in the `Authorization:` request header when you submit HTTP requests. Note that the access token will expire after 60 minutes (3600 seconds).\n\n### Submit HTTP requests\n\nThe following examples demonstrate how to send HTTP requests to list all\navailable data sources, and to create a new data source. For the Fitness REST\nAPI, the URI format is:\n\n`https://www.googleapis.com/fitness/v1/`\u003cvar class=\"apiparam\" translate=\"no\"\u003eresourcePath\u003c/var\u003e`?`\u003cvar class=\"apiparam\" translate=\"no\"\u003eparameters\u003c/var\u003e\n\n**To list all available data sources:**\n\n1. In **HTTP Method** , select **GET**.\n2. In **Request URI** , enter `https://www.googleapis.com/fitness/v1/users/me/dataSources`\n3. Click **Send the request**.\n\nThe request and the response appear on the right side of the page. If the\nrequest is successful, the response shows the data source from the previous\nexample in JSON format.\n\n**To create a data source:**\n\n1. In **HTTP Method** , select **POST**.\n2. In **Request URI** , enter `https://www.googleapis.com/fitness/v1/users/me/dataSources`\n3. Click **Enter request body**.\n4. In the **Request Body** window, copy and paste the following JSON:\n\n {\n \"dataStreamName\": \"MyDataSource\",\n \"type\": \"derived\",\n \"application\": {\n \"detailsUrl\": \"http://example.com\",\n \"name\": \"Foo Example App\",\n \"version\": \"1\"\n },\n \"dataType\": {\n \"field\": [\n {\n \"name\": \"steps\",\n \"format\": \"integer\"\n }\n ],\n \"name\": \"com.google.step_count.delta\"\n },\n \"device\": {\n \"manufacturer\": \"Example Manufacturer\",\n \"model\": \"ExampleTablet\",\n \"type\": \"tablet\",\n \"uid\": \"1000001\",\n \"version\": \"1\"\n }\n }\n\n5. In the **Request Body** window, click **Close**.\n\n6. Click **Send the request**.\n\nThe request and the response appear on the right side of the page. The request\nincludes the OAuth access token in the `Authorization` header:\n\n`Authorization: Bearer ya29.`\u003cvar class=\"apiparam\" translate=\"no\"\u003eOAuthTokenValue\u003c/var\u003e\n\nIf the request is successful, the first line of the response is:\n\n`HTTP/1.1 200 OK`\n\nUse cURL to access the Fit REST API\n-----------------------------------\n\nYou can use the [cURL](https://curl.haxx.se/) command line tool to access the\nFit REST API. You will need an OAuth access token to make requests\nusing cURL (see the preceding [instructions](#try_the_rest_api_in_the_oauth_playground)).\nNote that access tokens expire after an hour. The following example shows a\nsimple bash script to list all data sources. \n\n```bash\n#!/bin/bash\nACCESS_TOKEN=\"\"\ncurl \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $ACCESS_TOKEN\" \\\n https://www.googleapis.com/fitness/v1/users/me/dataSources\n```\n\nNext steps\n----------\n\nTo learn more about the REST API, see these pages:\n\n- [Fitness Data Types](/fit/rest/v1/data-types)\n- [Sessions](/fit/rest/v1/sessions)\n- [How to Record a Workout](/fit/rest/v1/workout)"]]
