REST API का इस्तेमाल शुरू करना

इस ट्यूटोरियल में बताया गया है कि Fitness REST API का ऐक्सेस कैसे चालू करें, OAuth ऐक्सेस टोकन कैसे हासिल करें, और एचटीटीपी अनुरोधों का इस्तेमाल करके एपीआई के तरीकों को कैसे शुरू करें.

Fitness REST API का इस्तेमाल करने के लिए, यह ज़रूरी है कि आप RESTफ़ुल वेब सेवाओं और JSON के बारे में जानकारी की बुनियादी बातों को समझ लें.

कोई Google खाता प्राप्त करें

Fitness REST API का इस्तेमाल करने के लिए, आपके पास Google खाता होना चाहिए. अगर आपके पास पहले से ही खाता है, तो आप पूरी तरह से तैयार हैं. जांच के लिए, एक अलग Google खाता भी बनाया जा सकता है.

OAuth 2.0 क्लाइंट आईडी का अनुरोध करना

Fitness API के लिए, OAuth 2.0 क्लाइंट आईडी का अनुरोध करने के लिए, यह तरीका अपनाएं.

1. Google API (एपीआई) कंसोल पर जाएं.
2. कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. अपने ऐप्लिकेशन के Android और REST वर्शन के लिए एक ही प्रोजेक्ट का इस्तेमाल करें.
3. Fitness API को चालू करने के लिए जारी रखें पर क्लिक करें.
4. क्रेडेंशियल पर जाएं पर क्लिक करें.
5. नए क्रेडेंशियल पर क्लिक करें. इसके बाद, OAuth क्लाइंट आईडी चुनें.
6. ऐप्लिकेशन का टाइप में जाकर, वेब ऐप्लिकेशन चुनें.
7. अनुमति वाले JavaScript ऑरिजिन में जाकर, उस साइट का बेस यूआरएल डालें जिससे अनुरोध आएंगे. उदाहरण के लिए, https://developers.google.com वह यूआरएल है जिसका इस्तेमाल OAuth Playground करता है.
8. अनुमति वाले रीडायरेक्ट यूआरआई में, उस साइट का यूआरएल डालें जहां जवाबों को मैनेज किया जाएगा. उदाहरण के लिए, https://developers.google.com/oauthplayground वह यूआरएल है जिसका इस्तेमाल OAuth प्लेग्राउंड तय करता है.

9. बनाएं पर क्लिक करें. आपका नया OAuth 2.0 क्लाइंट आईडी और सीक्रेट, आपके प्रोजेक्ट के आईडी की सूची में दिखता है. OAuth 2.0 क्लाइंट आईडी, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह से होती है:

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth प्लेग्राउंड में REST API को आज़माएं

OAuth प्लेग्राउंड, Fitness REST API के बारे में जानने का सबसे आसान तरीका है. ऐसा करने के लिए, एचटीटीपी अनुरोध सबमिट किए जाते हैं और क्लाइंट कोड लिखने से पहले, रिस्पॉन्स पर नज़र रखी जाती है.

OAuth Playground में, Fitness REST API को अनुमति देने के लिए:

1. OAuth प्लेग्राउंड पर जाएं.
2. पहला चरण: एपीआई चुनें और उन्हें अनुमति दें में, फ़िटनेस v1 को बड़ा करें और इस्तेमाल करने के लिए फ़िटनेस के स्कोप चुनें.
3. एपीआई को अनुमति दें बटन पर क्लिक करें, इस्तेमाल करने के लिए Google API कंसोल प्रोजेक्ट चुनें, और निर्देश मिलने पर अनुमति दें पर क्लिक करें. आपके पास, चुने गए Google API Console खाते से जुड़े डेटा को ऐक्सेस करने और उसमें बदलाव करने की सुविधा होगी.
4. टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करें बटन पर क्लिक करें. जब एचटीटीपी अनुरोध सबमिट किए जाते हैं, तो OAuth प्लेग्राउंड Authorization: अनुरोध के हेडर में अपने-आप यह हेडर शामिल कर लेता है. ध्यान दें कि ऐक्सेस टोकन 60 मिनट (3600 सेकंड) के बाद खत्म हो जाएगा.

एचटीटीपी अनुरोध सबमिट करें

यहां दिए गए उदाहरणों में बताया गया है कि सभी उपलब्ध डेटा सोर्स की सूची बनाने के लिए, एचटीटीपी अनुरोध कैसे भेजें और एक नया डेटा सोर्स कैसे बनाएं. Fitness REST API के लिए, यूआरआई का फ़ॉर्मैट यह होता है:

https://www.googleapis.com/fitness/v1/resourcePath?parameters

सभी उपलब्ध डेटा सोर्स की सूची बनाने के लिए:

1. एचटीटीपी तरीके में, GET चुनें.
2. अनुरोध यूआरआई में, https://www.googleapis.com/fitness/v1/users/me/dataSources डालें
3. अनुरोध भेजें पर क्लिक करें.

अनुरोध और उसका जवाब, पेज की दाईं ओर दिखता है. अनुरोध स्वीकार होने पर, रिस्पॉन्स में पिछले उदाहरण का डेटा सोर्स, JSON फ़ॉर्मैट में दिखता है.

डेटा सोर्स बनाने के लिए:

1. एचटीटीपी वाला तरीका विकल्प में, पोस्ट करें को चुनें.
2. अनुरोध यूआरआई में, https://www.googleapis.com/fitness/v1/users/me/dataSources डालें
3. अनुरोध का मुख्य हिस्सा डालें पर क्लिक करें.

4. अनुरोध का मुख्य हिस्सा विंडो में, नीचे दिए गए 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"
     }
   }
   
   

5. अनुरोध का मुख्य हिस्सा विंडो में, बंद करें पर क्लिक करें.

6. अनुरोध भेजें पर क्लिक करें.

अनुरोध और उसका जवाब, पेज की दाईं ओर दिखता है. इस अनुरोध में, Authorization हेडर में OAuth ऐक्सेस टोकन शामिल है:

Authorization: Bearer ya29.OAuthTokenValue

अगर अनुरोध स्वीकार कर लिया जाता है, तो जवाब की पहली लाइन यह होगी:

HTTP/1.1 200 OK

Fit REST API को ऐक्सेस करने के लिए, cURL का इस्तेमाल करें

Fit REST API को ऐक्सेस करने के लिए, cURL कमांड लाइन टूल का इस्तेमाल किया जा सकता है. cURL का इस्तेमाल करके अनुरोध करने के लिए, आपको OAuth ऐक्सेस टोकन की ज़रूरत होगी (पिछले instructions देखें). ध्यान दें कि ऐक्सेस टोकन की समयसीमा एक घंटे बाद खत्म हो जाती है. नीचे दिए गए उदाहरण में, सभी डेटा सोर्स की सूची बनाने के लिए एक आसान बैश स्क्रिप्ट दिखाई गई है.

#!/bin/bash
ACCESS_TOKEN=""
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

अगले चरण

REST API के बारे में ज़्यादा जानने के लिए, इन पेजों को देखें:

• फ़िटनेस का डेटा टाइप
• सेशन
• कसरत को रिकॉर्ड करने का तरीका