Các API của Google Fit, bao gồm cả API Google Fit REST, sẽ ngừng hoạt động vào năm 2026. Kể từ ngày 1 tháng 5 năm 2024, nhà phát triển không thể đăng ký sử dụng các API này.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này chỉ cho bạn cách kích hoạt quyền truy cập vào Fitness REST API, nhận quyền truy cập OAuth
mã thông báo và gọi các phương thức API bằng cách sử dụng yêu cầu HTTP.
Để sử dụng API Fitness REST, bạn cần có Tài khoản Google.
Nếu đã có tài khoản thì bạn đã hoàn tất. Có thể bạn cũng muốn
tạo một Tài khoản Google riêng cho mục đích thử nghiệm.
Yêu cầu mã ứng dụng khách OAuth 2.0
Hãy làm theo các bước sau để yêu cầu mã ứng dụng khách OAuth 2.0 cho Fitness API.
Chọn dự án hoặc tạo dự án mới. Sử dụng cùng một dự án cho Android
và REST của ứng dụng.
Nhấp vào Tiếp tục để bật API Fitness.
Nhấp vào Chuyển đến trang thông tin xác thực.
Nhấp vào Thông tin xác thực mới, sau đó chọn Mã ứng dụng OAuth.
Trong Application type (Loại ứng dụng), hãy chọn Web application (Ứng dụng web).
Trong phần Nguồn gốc JavaScript được cho phép, hãy nhập URL cơ sở của trang web
nguồn gốc của các yêu cầu (ví dụ: https://developers.google.com
là URL mà OAuth Playground sử dụng).
Trong mục URI chuyển hướng được phép, hãy nhập URL của trang web chứa phản hồi
sẽ được xử lý (ví dụ: https://developers.google.com/oauthplayground
là URL mà OAuth Playground sử dụng).
Nhấp vào Tạo. Mã ứng dụng khách OAuth 2.0 và bí mật mới của bạn sẽ xuất hiện trong danh sách
cho dự án của bạn. Mã ứng dụng OAuth 2.0 là một chuỗi ký tự,
tương tự như sau:
OAuth Playground là cách dễ nhất để làm quen với
API REST thể dục bằng cách gửi các yêu cầu HTTP và quan sát các phản hồi trước khi
bạn viết bất kỳ mã ứng dụng khách nào.
Cách uỷ quyền API Fitness REST trong OAuth Playground:
Trong Bước 1, hãy chọn & uỷ quyền cho API, mở rộng mục Thể dục phiên bản 1 rồi chọn
Phạm vi thể dục để sử dụng.
Nhấp vào nút Authorize APIs (Cho phép API), chọn dự án Google API Console để
sử dụng và nhấp vào Cho phép khi được nhắc. Bạn sẽ có thể truy cập và
sửa đổi dữ liệu được liên kết với tài khoản Google API Console đã chọn.
Nhấp vào nút Mã uỷ quyền Exchange cho mã thông báo. OAuth
Playground tự động đưa tiêu đề này vào Authorization:
khi gửi yêu cầu HTTP. Xin lưu ý rằng mã truy cập
sẽ hết hạn sau 60 phút (3600 giây).
Gửi yêu cầu HTTP
Các ví dụ sau minh hoạ cách gửi yêu cầu HTTP để liệt kê tất cả
nguồn dữ liệu có sẵn và tạo nguồn dữ liệu mới. Dành cho Kiến trúc chuyển trạng thái thể dục (REST)
API, định dạng URI là:
Trong URI yêu cầu, nhập https://www.googleapis.com/fitness/v1/users/me/dataSources
Nhấp vào Gửi yêu cầu.
Yêu cầu và phản hồi sẽ xuất hiện ở phía bên phải của trang. Nếu
yêu cầu thành công, phản hồi cho thấy nguồn dữ liệu từ
ví dụ ở định dạng JSON.
Cách tạo một nguồn dữ liệu:
Trong Phương thức HTTP, chọn ĐĂNG.
Trong URI yêu cầu, nhập https://www.googleapis.com/fitness/v1/users/me/dataSources
Nhấp vào Nhập nội dung yêu cầu.
Trong cửa sổ Request body (Yêu cầu nội dung), hãy sao chép và dán tệp JSON sau:
{"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"}}
Trong cửa sổ Request Content (Nội dung yêu cầu), hãy nhấp vào Close (Đóng).
Nhấp vào Gửi yêu cầu.
Yêu cầu và phản hồi sẽ xuất hiện ở phía bên phải của trang. Yêu cầu
bao gồm mã truy cập OAuth trong tiêu đề Authorization:
Authorization: Bearer ya29.OAuthTokenValue
Nếu yêu cầu thành công, dòng đầu tiên của phản hồi là:
HTTP/1.1 200 OK
Dùng cURL để truy cập vào API Fit REST
Bạn có thể sử dụng công cụ dòng lệnh cURL để truy cập vào
API Fit REST. Bạn cần có mã truy cập OAuth để thực hiện yêu cầu
bằng cách sử dụng cURL (xem hướng dẫn trước đó).
Xin lưu ý rằng mã truy cập sẽ hết hạn sau một giờ. Ví dụ sau đây cho thấy
tập lệnh bash đơn giản để liệt kê tất cả các nguồn dữ liệu.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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)"]]
