בוחרים פרויקט או יוצרים פרויקט חדש. שימוש באותו פרויקט בשביל Android
ו-REST של האפליקציה שלך.
לוחצים על המשך כדי להפעיל את Fitbit API.
לוחצים על Go to credentials (מעבר אל פרטי הכניסה).
לוחצים על New credentials (פרטי כניסה חדשים) ובוחרים באפשרות OAuth Client ID (מזהה לקוח OAuth).
בקטע Application type (סוג אפליקציה), בוחרים באפשרות Web application.
בקטע מקורות JavaScript מורשים, מזינים את כתובת ה-URL הבסיסית של האתר
שממנו יגיעו הבקשות (לדוגמה, https://developers.google.com
היא כתובת ה-URL שמשמשת את OAuth Playground).
בקטע URI של הפניה אוטומטית מורשית, מזינים את כתובת ה-URL של האתר שבו תגובות
יטופל (לדוגמה https://developers.google.com/oauthplayground
היא כתובת ה-URL שמשמשת את OAuth Playground).
לוחצים על יצירה. הסוד ומזהה הלקוח החדשים של OAuth 2.0 מופיעים ברשימה
של המזהים בפרויקט. מזהה הלקוח של OAuth 2.0 הוא מחרוזת של תווים,
בערך כך:
בקטע שלב 1 בחירה ו מתן הרשאה לממשקי API, מרחיבים את Fitness v1 ובוחרים
היקף הכושר לשימוש.
לוחצים על הלחצן Authorize APIs, ואז בוחרים את הפרויקט ב-Google API Console כדי
להשתמש וללחוץ על אישור כשתוצג הבקשה. תהיה לך אפשרות לגשת אל
שינוי הנתונים המשויכים לחשבון Google API Console שנבחר.
לוחצים על הלחצן החלפת קוד הרשאה לאסימונים. פרוטוקול OAuth
מערכת Playground כוללת את הכותרת הזו באופן אוטומטי בAuthorization:
בכותרת הבקשה כששולחים בקשות HTTP. שימו לב שאסימון הגישה
יפוג לאחר 60 דקות (3,600 שניות).
שליחת בקשות HTTP
הדוגמאות הבאות ממחישות איך לשלוח בקשות HTTP כדי להציג רשימה של כל
מקורות נתונים זמינים, וליצור מקור נתונים חדש. ל-Fitness ב-REST
API, הפורמט של ה-URI הוא:
בקטע URI של בקשה, מזינים https://www.googleapis.com/fitness/v1/users/me/dataSources
לוחצים על שליחת הבקשה.
הבקשה והתגובה יופיעו בצד שמאל של הדף. אם
הבקשה בוצעה בהצלחה, התגובה מציגה את מקור הנתונים
לדוגמה בפורמט JSON.
כדי ליצור מקור נתונים:
ב-HTTP Method, בוחרים POST.
בקטע URI של בקשה, מזינים https://www.googleapis.com/fitness/v1/users/me/dataSources
לוחצים על הזנת גוף הבקשה.
בחלון 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"}}
בחלון Request Body לוחצים על Close.
לוחצים על שליחת הבקשה.
הבקשה והתגובה יופיעו בצד שמאל של הדף. הבקשה
כולל את אסימון הגישה ל-OAuth בכותרת Authorization:
Authorization: Bearer ya29.OAuthTokenValue
אם הבקשה תסתיים בהצלחה, השורה הראשונה בתשובה תהיה:
HTTP/1.1 200 OK
שימוש ב-cURL כדי לגשת ל-API של Fit ל-REST
אפשר להשתמש בכלי שורת הפקודה cURL כדי לגשת
התאמה ל-API בארכיטקטורת REST. כדי לשלוח בקשות, יהיה צורך באסימון גישה ל-OAuth
באמצעות cURL (ראו הוראות למעלה).
חשוב לזכור שהתוקף של אסימוני גישה פג אחרי שעה. הדוגמה הבאה מראה
סקריפט bash פשוט שכולל רשימה של כל מקורות הנתונים.
[[["התוכן קל להבנה","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-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)"]]
