Google Fit REST API de dahil olmak üzere Google Fit API'lerinin desteği 2026'da sonlandırılacak. 1 Mayıs 2024'ten itibaren geliştiriciler bu API'leri kullanmak için kaydolamaz.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu eğitimde, Fitness REST API'ye erişimi nasıl etkinleştireceğiniz, OAuth erişimi nasıl elde edeceğiniz gösterilmektedir
yapabilir ve HTTP isteklerini kullanarak API yöntemlerini çağırabilir.
Fitness REST API'yi kullanmak için bir Google Hesabınız olmalıdır.
Halihazırda bir hesabınız varsa hazırsınız demektir. Ayrıca isterseniz
test amacıyla ayrı bir Google Hesabı oluşturmalıdır.
OAuth 2.0 istemci kimliği isteyin
Fitness API için OAuth 2.0 istemci kimliği istemek üzere aşağıdaki adımları uygulayın.
Bir proje seçin veya yeni bir proje oluşturun. Android için aynı projeyi kullan
ve REST sürümleri oluşturun.
Fitness API'yi etkinleştirmek için Devam'ı tıklayın.
Kimlik bilgilerine git'i tıklayın.
New credentials'ı (Yeni kimlik bilgileri) tıklayın ve ardından OAuth Client ID (OAuth İstemci Kimliği) seçin.
Uygulama türü bölümünde Web uygulaması'nı seçin.
Yetkili JavaScript kaynakları altında, sitenin temel URL'sini girin
İsteklerin kaynaklanacağı yer (örneğin, https://developers.google.com)
OAuth Playground tarafından kullanılan URL'dir).
Yetkili yönlendirme URI'si altında, yanıtların
işlenecek (örneğin, https://developers.google.com/oauthplayground)
OAuth Playground tarafından kullanılan URL'dir).
Oluştur'u tıklayın. Yeni OAuth 2.0 istemci kimliğiniz ve gizli anahtarınız listede görünür
ortaya çıkarır. OAuth 2.0 Client-ID, karakterlerden oluşan bir dizedir.
şunun gibi bir şey:
OAuth Playground, OAuth Playground'u tanımanın en kolay yoludur ve
Önceden HTTP istekleri göndererek ve yanıtları inceleyerek Fitness REST API'yi
istemci kodu yazabilirsiniz.
API'leri Yetkilendir düğmesini tıklayın, yapılacak Google API Konsolu projesini seçin
kullanıyorsanız ve istendiğinde İzin ver'i tıklayın. Şuna erişebilir:
seçili Google API Konsolu hesabıyla ilişkili verileri değiştirme.
Jetonlar için yetkilendirme kodu değiş tokuşu yap düğmesini tıklayın. OAuth
Playground bu başlığı otomatik olarak Authorization: içine ekler
istek başlığını girin. Erişim jetonunun
süresi 60 dakika (3.600 saniye) sonra sona erer.
HTTP istekleri gönderme
Aşağıdaki örnekler, tüm
mevcut veri kaynaklarını gözden geçirmek ve yeni bir veri kaynağı oluşturmak. Fitness REST İçin
API'nin URI biçimi şu şekildedir:
HTTP Method (HTTP Yöntemi) bölümünde GET'i (GET) seçin.
İstek URI'si alanına https://www.googleapis.com/fitness/v1/users/me/dataSources yazın.
İsteği gönder'i tıklayın.
İstek ve yanıt, sayfanın sağ tarafında görünür. Öğe
isteği başarılı olursa yanıt, önceki sayfanın veri kaynağı
JSON biçiminde bir örnek.
Veri kaynağı oluşturmak için:
HTTP Method (HTTP Yöntemi) bölümünde POST'u seçin.
İstek URI'si alanına https://www.googleapis.com/fitness/v1/users/me/dataSources yazın.
İstek gövdesini girin'i tıklayın.
Request Body (İstek Gövdesi) penceresinde aşağıdaki JSON'u kopyalayıp yapıştırın:
{"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"}}
İstek Gövdesi penceresinde Kapat'ı tıklayın.
İsteği gönder'i tıklayın.
İstek ve yanıt, sayfanın sağ tarafında görünür. İstek
Authorization üst bilgisinde OAuth erişim jetonunu içerir:
Authorization: Bearer ya29.OAuthTokenValue
İstek başarılı olursa yanıtın ilk satırı şöyle olur:
HTTP/1.1 200 OK
Fit REST API'ye erişmek için cURL'yi kullanma
Şuraya erişmek için cURL komut satırı aracını kullanabilirsiniz:
Fit REST API. İstekte bulunmak için OAuth erişim jetonuna ihtiyacınız olacaktır
cURL kullanarak (önceki talimatlara bakın).
Erişim jetonlarının süresinin bir saat sonra sona ereceğini unutmayın. Aşağıdaki örnekte bir
basit bash komut dosyası ile tüm veri kaynaklarını listeler.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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)"]]
