APIهای Google Fit، از جمله Google Fit REST API، در سال 2026 منسوخ خواهند شد . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این آموزش به شما نشان می‌دهد که چگونه می‌توانید دسترسی به Fitness REST API را فعال کنید، نشانه‌های دسترسی OAuth را بدست آورید و روش‌های API را با استفاده از درخواست‌های HTTP فراخوانی کنید.
برای استفاده از Fitness REST API، به یک حساب Google نیاز دارید. اگر قبلاً یک حساب کاربری دارید، پس همه چیز آماده است. همچنین ممکن است بخواهید یک حساب Google جداگانه برای اهداف آزمایشی ایجاد کنید.
شناسه مشتری OAuth 2.0 را درخواست کنید
برای درخواست شناسه مشتری OAuth 2.0 برای Fitness API این مراحل را دنبال کنید.
یک پروژه را انتخاب کنید یا یک پروژه جدید ایجاد کنید. از همین پروژه برای نسخه های Android و REST برنامه خود استفاده کنید.
برای فعال کردن Fitness API روی Continue کلیک کنید.
برو به اعتبارنامه کلیک کنید.
روی New credentials کلیک کنید، سپس OAuth Client ID را انتخاب کنید.
در قسمت Application type ، Web application را انتخاب کنید.
در زیر مبداهای مجاز جاوا اسکریپت ، نشانی اینترنتی اصلی سایتی را که درخواست‌ها از آن منشأ می‌شوند، وارد کنید (برای مثال https://developers.google.com نشانی اینترنتی مورد استفاده OAuth Playground است).
در قسمت URI تغییر مسیر مجاز ، نشانی وب سایتی را که در آن پاسخ ها رسیدگی می شود وارد کنید (به عنوان مثال https://developers.google.com/oauthplayground نشانی اینترنتی مورد استفاده OAuth Playground است).
روی ایجاد کلیک کنید. شناسه مشتری OAuth 2.0 و راز جدید شما در لیست شناسه های پروژه شما ظاهر می شود. OAuth 2.0 Client ID رشته ای از کاراکترها است، چیزی شبیه به این:
در مرحله 1 APIها را انتخاب و تأیید کنید ، Fitness v1 را گسترش دهید و دامنه‌های Fitness را برای استفاده انتخاب کنید.
روی دکمه Authorize APIs کلیک کنید، پروژه Google API Console را برای استفاده انتخاب کنید و وقتی از شما خواسته شد روی Allow کلیک کنید. می‌توانید به داده‌های مرتبط با حساب Google API Console انتخاب‌شده دسترسی داشته باشید و آن‌ها را تغییر دهید.
روی دکمه مجوز Exchange for tokens کلیک کنید. وقتی درخواست‌های HTTP را ارسال می‌کنید، OAuth Playground به‌طور خودکار این هدر را در Authorization: درخواست قرار می‌دهد. توجه داشته باشید که رمز دسترسی پس از 60 دقیقه (3600 ثانیه) منقضی می شود.
درخواست های HTTP را ارسال کنید
مثال‌های زیر نحوه ارسال درخواست‌های HTTP برای فهرست کردن همه منابع داده‌های موجود و ایجاد یک منبع داده جدید را نشان می‌دهند. برای Fitness REST API، فرمت URI به صورت زیر است:
در درخواست URI ، https://www.googleapis.com/fitness/v1/users/me/dataSources را وارد کنید
روی ارسال درخواست کلیک کنید.
درخواست و پاسخ در سمت راست صفحه ظاهر می شود. اگر درخواست موفقیت آمیز باشد، پاسخ منبع داده نمونه قبلی را در قالب JSON نشان می دهد.
برای ایجاد یک منبع داده:
در روش HTTP ، POST را انتخاب کنید.
در درخواست URI ، https://www.googleapis.com/fitness/v1/users/me/dataSources را وارد کنید
روی Enter request body کلیک کنید.
در پنجره Request Body ، 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"}}
در پنجره درخواست بدنه ، روی بستن کلیک کنید.
روی ارسال درخواست کلیک کنید.
درخواست و پاسخ در سمت راست صفحه ظاهر می شود. این درخواست شامل نشانه دسترسی OAuth در سربرگ Authorization است:
Authorization: Bearer ya29. OAuthTokenValue
در صورت موفقیت آمیز بودن درخواست، خط اول پاسخ به صورت زیر است:
HTTP/1.1 200 OK
برای دسترسی به Fit REST API از cURL استفاده کنید
می توانید از ابزار خط فرمان cURL برای دسترسی به Fit REST API استفاده کنید. برای درخواست با استفاده از cURL به یک نشانه دسترسی OAuth نیاز دارید (به دستورالعمل های قبلی مراجعه کنید). توجه داشته باشید که نشانه های دسترسی پس از یک ساعت منقضی می شوند. مثال زیر یک اسکریپت bash ساده را برای فهرست کردن همه منابع داده نشان می دهد.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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)"]]
