REST API দিয়ে শুরু করা

এই টিউটোরিয়ালটি আপনাকে দেখায় কিভাবে Fitness REST API-তে অ্যাক্সেস সক্রিয় করতে হয়, OAuth অ্যাক্সেস টোকেন পেতে হয় এবং HTTP অনুরোধগুলি ব্যবহার করে API পদ্ধতিগুলি ব্যবহার করতে হয়।

ফিটনেস REST API ব্যবহার করার জন্য, RESTful ওয়েব পরিষেবা এবং JSON উপস্থাপনাগুলির মূল বিষয়গুলি বোঝা গুরুত্বপূর্ণ।

একটি Google অ্যাকাউন্ট পান

ফিটনেস 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. অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন এর অধীনে, যে সাইটের অনুরোধগুলি আসবে তার মূল URLটি প্রবেশ করান (উদাহরণস্বরূপ https://developers.google.com হল OAuth প্লেগ্রাউন্ড দ্বারা ব্যবহৃত URL)।
  8. অনুমোদিত পুনঃনির্দেশ URI-এর অধীনে, সাইটের URL লিখুন যেখানে প্রতিক্রিয়াগুলি পরিচালনা করা হবে (উদাহরণস্বরূপ https://developers.google.com/oauthplayground হল OAuth প্লেগ্রাউন্ড দ্বারা ব্যবহৃত URL)।

  9. তৈরি করুন ক্লিক করুন। আপনার নতুন OAuth 2.0 ক্লায়েন্ট আইডি এবং গোপনীয়তা আপনার প্রকল্পের জন্য আইডিগুলির তালিকায় প্রদর্শিত হবে৷ একটি OAuth 2.0 ক্লায়েন্ট আইডি অক্ষরের একটি স্ট্রিং, এইরকম কিছু:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

OAuth খেলার মাঠে REST API ব্যবহার করে দেখুন

OAuth প্লেগ্রাউন্ড হল HTTP অনুরোধ জমা দেওয়ার মাধ্যমে এবং ক্লায়েন্ট কোড লেখার আগে প্রতিক্রিয়াগুলি পর্যবেক্ষণ করে ফিটনেস REST API-এর সাথে নিজেকে পরিচিত করার সবচেয়ে সহজ উপায়৷

OAuth খেলার মাঠে ফিটনেস REST API অনুমোদন করতে:

  1. OAuth খেলার মাঠে যান।
  2. ধাপ 1 এর অধীনে API নির্বাচন করুন এবং অনুমোদন করুন , ফিটনেস v1 প্রসারিত করুন এবং ব্যবহার করার জন্য ফিটনেস স্কোপগুলি নির্বাচন করুন৷
  3. APIs অনুমোদন বোতামে ক্লিক করুন, ব্যবহার করার জন্য Google API কনসোল প্রকল্পটি নির্বাচন করুন এবং অনুরোধ করা হলে Allow এ ক্লিক করুন। আপনি নির্বাচিত Google API কনসোল অ্যাকাউন্টের সাথে যুক্ত ডেটা অ্যাক্সেস এবং সংশোধন করতে সক্ষম হবেন৷
  4. টোকেন বোতামের জন্য এক্সচেঞ্জ অনুমোদন কোডে ক্লিক করুন। আপনি যখন HTTP অনুরোধ জমা দেন তখন OAuth প্লেগ্রাউন্ড স্বয়ংক্রিয়ভাবে Authorization: অনুরোধ শিরোনামে এই শিরোনামটি অন্তর্ভুক্ত করে। নোট করুন যে অ্যাক্সেস টোকেনের মেয়াদ 60 মিনিট (3600 সেকেন্ড) পরে শেষ হবে।

HTTP অনুরোধ জমা দিন

নিম্নলিখিত উদাহরণগুলি দেখায় যে সমস্ত উপলব্ধ ডেটা উত্সগুলি তালিকাভুক্ত করতে এবং একটি নতুন ডেটা উত্স তৈরি করতে কীভাবে HTTP অনুরোধ পাঠাতে হয়৷ ফিটনেস REST API-এর জন্য, URI বিন্যাস হল:

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

সমস্ত উপলব্ধ ডেটা উত্স তালিকাভুক্ত করতে:

  1. HTTP পদ্ধতিতে , GET নির্বাচন করুন।
  2. অনুরোধ URI- এ, https://www.googleapis.com/fitness/v1/users/me/dataSources লিখুন
  3. অনুরোধ পাঠান ক্লিক করুন.

অনুরোধ এবং প্রতিক্রিয়া পৃষ্ঠার ডানদিকে প্রদর্শিত হবে। অনুরোধ সফল হলে, প্রতিক্রিয়া JSON ফর্ম্যাটে আগের উদাহরণ থেকে ডেটা উত্স দেখায়৷

একটি ডেটা উত্স তৈরি করতে:

  1. HTTP পদ্ধতিতে , POST নির্বাচন করুন।
  2. অনুরোধ URI- এ, 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. রিকোয়েস্ট বডি উইন্ডোতে, Close এ ক্লিক করুন।

  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 সম্পর্কে আরও জানতে, এই পৃষ্ঠাগুলি দেখুন: