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

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

फ़िटनेस REST API का इस्तेमाल करने के लिए, इसकी बुनियादी बातों को समझना ज़रूरी है RESTful वेब सेवाएं और 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 Client-ID चुनें.
6. ऐप्लिकेशन टाइप में जाकर, वेब ऐप्लिकेशन चुनें.
7. अनुमति वाले JavaScript ऑरिजिन में जाकर, साइट का बेस यूआरएल डालें किस तरह के अनुरोध मिलेंगे (उदाहरण के लिए https://developers.google.com वह यूआरएल है जिसे OAuth प्लेग्राउंड इस्तेमाल करता है).
8. अनुमति वाले रीडायरेक्ट यूआरआई में जाकर, उस साइट का यूआरएल डालें जहां जवाब मिलता है को हैंडल किया जाएगा (उदाहरण के लिए, https://developers.google.com/oauthplayground वह यूआरएल है जिसे OAuth प्लेग्राउंड इस्तेमाल करता है).

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

   780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

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

OAuth प्लेग्राउंड, उपयोगकर्ताओं के लिए फ़िटनेस REST API (एपीआई) के लिए एचटीटीपी अनुरोध सबमिट करें और पहले दिए गए जवाबों की निगरानी करें तो आपको कोई क्लाइंट कोड लिखने की ज़रूरत नहीं पड़ेगी.

OAuth प्लेग्राउंड में Fitness REST API को अनुमति देने के लिए:

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

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

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

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

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

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

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

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

1. एचटीटीपी तरीका में, POST चुनें.
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 का इस्तेमाल करें

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

#!/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 के बारे में ज़्यादा जानने के लिए, इन पेजों को देखें:

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