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

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

Fitness 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 Playground का इस्तेमाल किया जाने वाला यूआरएल है.

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth Playground में REST API आज़माना

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

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

  1. OAuth Playground पर जाएं.
  2. पहला चरण: एपीआई चुनना और उन्हें अनुमति देना में जाकर, Fitness v1 को बड़ा करें. इसके बाद, इस्तेमाल करने के लिए Fitness के स्कोप चुनें.
  3. एपीआई को अनुमति दें बटन पर क्लिक करें. इसके बाद, इस्तेमाल करने के लिए Google API कंसोल प्रोजेक्ट चुनें और कहा जाने पर अनुमति दें पर क्लिक करें. आपके पास चुने गए Google API Console खाते से जुड़े डेटा को ऐक्सेस करने और उसमें बदलाव करने का विकल्प होगा.
  4. टोकन के लिए ऑथराइज़ेशन कोड बदलें बटन पर क्लिक करें. एचटीटीपी अनुरोध सबमिट करने पर, OAuth Playground इस हेडर को 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. एचटीटीपी तरीका में, POST चुनें.
  2. अनुरोध यूआरआई में, https://www.googleapis.com/fitness/v1/users/me/dataSources डालें
  3. अनुरोध का मुख्य हिस्सा डालें पर क्लिक करें.

  4. 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"
  }
}

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

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

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

Authorization: Bearer ya29.OAuthTokenValue

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

HTTP/1.1 200 OK

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

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

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