REST API से शुरू करना

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

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

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

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

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

फ़िटनेस एपीआई का OAuth 2.0 क्लाइंट आईडी मांगने के लिए, यह तरीका अपनाएं.

  1. Google API (एपीआई) कंसोल पर जाएं.
  2. कोई प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. अपने ऐप्लिकेशन के Android और REST वर्शन के लिए एक ही प्रोजेक्ट का इस्तेमाल करें.
  3. फ़िटनेस एपीआई को चालू करने के लिए जारी रखें पर क्लिक करें.
  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 प्लेग्राउंड में फ़िटनेस REST API को अनुमति देने के लिए:

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

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

इन उदाहरणों में, सभी उपलब्ध डेटा सोर्स की सूची बनाने और एक नया डेटा सोर्स बनाने के लिए, एचटीटीपी अनुरोध भेजने का तरीका बताया गया है. फ़िटनेस 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 ऐक्सेस टोकन की ज़रूरत होगी. पिछले निर्देश देखें. ध्यान दें कि ऐक्सेस टोकन की समयसीमा एक घंटे के बाद खत्म हो जाती है. नीचे दिए गए उदाहरण में, सभी डेटा सोर्स की सूची बनाने के लिए, एक आसान बैश स्क्रिप्ट दिखाई गई है.

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