ডেটা স্টুডিও এপিআই

ডেটা স্টুডিও এপিআই আপনাকে ডেটা স্টুডিও অ্যাসেট অনুসন্ধান ও পরিচালনা করার সুযোগ দেয়।

এই এপিআই-এর প্রধান ব্যবহার হলো গুগল ওয়ার্কস্পেস বা ক্লাউড আইডেন্টিটি অর্গানাইজেশনগুলোকে ডেটা স্টুডিও অ্যাসেটগুলোর ব্যবস্থাপনা ও মাইগ্রেশন স্বয়ংক্রিয় করতে সক্ষম করা।

মূল বিষয়: এই এপিআইটি শুধুমাত্র সেইসব ব্যবহারকারীদের জন্য উপলব্ধ, যারা গুগল ওয়ার্কস্পেস বা ক্লাউড আইডেন্টিটি সম্পন্ন কোনো সংস্থার সদস্য।

প্রয়োজনীয়তার সংক্ষিপ্ত বিবরণ

ডেটা স্টুডিও এপিআই ব্যবহার করার জন্য নিম্নলিখিত ধাপগুলো অনুসরণ করতে হবে:

1. এপিআই ব্যবহার করার জন্য একটি অ্যাপ কনফিগার করুন ।
2. অ্যাপটিকে অনুমোদন দিতে গুগল অ্যাডমিন কনসোল ব্যবহার করুন ।
3. OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করুন এবং API-কে কল করুন ।

নিম্নলিখিত সাধারণ পরিস্থিতিগুলোর উপর ভিত্তি করে উপরের ধাপগুলো একই বা ভিন্ন ভিন্ন সংস্থা দ্বারা সম্পাদিত হতে পারে:

• একটি প্রতিষ্ঠানের জন্য তৈরি অভ্যন্তরীণ অ্যাপ । প্রতিষ্ঠানটি তাদের সকল ব্যবহারকারীর জন্য অ্যাপটি কনফিগার ও অনুমোদন করে।
• বহিরাগত ব্যবহারকারী/গ্রাহকদের জন্য তৈরি থার্ড-পার্টি অ্যাপ (অর্থাৎ ডেভেলপার এবং ব্যবহারকারী ভিন্ন ভিন্ন প্রতিষ্ঠানের)। ডেভেলপার অ্যাপটি কনফিগার করে, কিন্তু ব্যবহারকারীর প্রতিষ্ঠান থার্ড-পার্টি অ্যাপটিকে অনুমোদন দেয়।

১. এপিআই ব্যবহার করার জন্য একটি অ্যাপ কনফিগার করুন।

আপনার অ্যাপ কনফিগার করতে নিম্নলিখিতগুলি সম্পূর্ণ করুন:

• এপিআই সক্রিয় করুন
• একটি OAuth ক্লায়েন্ট তৈরি করুন

এপিআই সক্রিয় করুন

আপনার প্রোজেক্টের জন্য একটি API সক্রিয় করতে:

1. Google API Console-এ [Data Studio API] খুলুন।
2. অনুরোধ করা হলে, একটি প্রজেক্ট নির্বাচন করুন অথবা নতুন একটি তৈরি করুন।
3. সক্ষম করুন -এ ক্লিক করুন।
4. অনুরোধ করা হলে, এপিআই-এর পরিষেবার শর্তাবলী পড়ুন এবং গ্রহণ করুন।

একটি OAuth ক্লায়েন্ট তৈরি করুন

OAuth ক্লায়েন্ট তৈরি করার জন্য নিম্নলিখিত ধাপগুলো সাধারণ নির্দেশিকা মাত্র এবং আপনার অ্যাপের প্রয়োজন অনুযায়ী এগুলোকে পরিবর্তন করা উচিত।

গুরুত্বপূর্ণ: আপনার OAuth ক্লায়েন্টে ডেটা স্টুডিও স্কোপ যোগ করবেন না। ওয়ার্কস্পেস অ্যাডমিন অ্যাপটিকে অনুমোদন করার সময় স্কোপগুলি যোগ করবেন।

1. OAuth সম্মতি কনফিগার করার স্ক্রিনে যান।
   1. ইন্টারনাল নির্বাচন করুন, ক্রিয়েট-এ ক্লিক করুন।
   2. প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন, সেভ-এ ক্লিক করুন।
2. ক্রেডেনশিয়ালস -এ যান।
   1. ক্রেডেনশিয়াল তৈরি করুন- এ ক্লিক করুন।
   2. OAuth ক্লায়েন্ট আইডি নির্বাচন করুন।
   3. উপযুক্ত Application Type নির্বাচন করুন। (ওয়েব অ্যাপ্লিকেশন সবচেয়ে প্রচলিত)।
   4. প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন, তারপর তৈরি করুন-এ ক্লিক করুন।
3. ক্লায়েন্ট আইডিটি লিখে রাখুন, কারণ এটি অ্যাপটিকে অনুমোদন দিতে ব্যবহৃত হয়।

২. একটি প্রতিষ্ঠানের জন্য অ্যাপটিকে অনুমোদন দিন

ডেটা স্টুডিও এপিআই ব্যবহারকারী অ্যাপগুলি শুধুমাত্র সেইসব গুগল ওয়ার্কস্পেস ব্যবহারকারীদের প্রমাণীকরণ এবং অনুমোদন করতে পারে, যেখানে ব্যবহারকারীর সংস্থা এপিআই অ্যাক্সেস নিয়ন্ত্রণের জন্য ডোমেন-ব্যাপী ডেলিগেশন ব্যবহার করে অ্যাপটিকে অনুমোদন দিয়েছে।

অ্যাপটির OAuth ক্লায়েন্ট আইডি এবং অ্যাপটির প্রয়োজনীয় স্কোপগুলো ব্যবহার করে ডোমেন-ব্যাপী ডেলিগেশন কনফিগার করুন।

গুরুত্বপূর্ণ: নিম্নলিখিত ধাপগুলো অবশ্যই একজন ওয়ার্কস্পেস অ্যাডমিনকে সম্পন্ন করতে হবে। অ্যাডমিনের অ্যাপটির OAuth ক্লায়েন্ট আইডি এবং অ্যাপটির জন্য প্রয়োজনীয় OAuth স্কোপগুলোর একটি তালিকা প্রয়োজন হবে।

1. আপনার গুগল অ্যাডমিন কনসোলে সাইন ইন করুন এবং ডোমেন ওয়াইড ডেলিগেশন- এ যান।
2. API clients এ, 'নতুন যোগ করুন'- এ ক্লিক করুন।
3. অনুমোদন করার জন্য অ্যাপটির Client ID লিখুন (অর্থাৎ, যে অ্যাপটি ডেটা স্টুডিও এপিআই ব্যবহার করে)।
4. অ্যাপটির জন্য প্রয়োজনীয় সমস্ত OAuth স্কোপ লিখুন। ডেটা স্টুডিও এপিআই ব্যবহার করে অ্যাসেট পরিচালনা করার ক্ষেত্রে সাধারণত নিম্নলিখিত স্কোপগুলির অনুরোধ করা হয়:
   • https://www.googleapis.com/auth/datastudio
   • https://www.googleapis.com/auth/userinfo.profile
5. অনুমোদন করুন- এ ক্লিক করুন।

দ্রষ্টব্য: যদি আপনার অ্যাপের ডেটা স্টুডিও অ্যাসেট পরিচালনা করার প্রয়োজন না হয়, তাহলে https://www.googleapis.com/auth/datastudio এর পরিবর্তে আরও সীমাবদ্ধ https://www.googleapis.com/auth/datastudio.readonly স্কোপটি ব্যবহার করার কথা বিবেচনা করুন।

অ্যাপটি অনুমোদন করার পর, প্রতিষ্ঠানের অন্তর্গত যেকোনো ওয়ার্কস্পেস ব্যবহারকারী ডেটা স্টুডিও এপিআই (Data Studio API) ব্যবহার করার জন্য স্বয়ংক্রিয়ভাবে অনুমোদিত হয়ে যাবেন।

৩. OAuth 2.0 অ্যাক্সেস টোকেন সংগ্রহ করা এবং API কল করা

একবার আপনি অ্যাপটি তৈরি এবং অনুমোদন করে নিলে, ওয়ার্কস্পেস ব্যবহারকারীদের জন্য এপিআই কল করার প্রয়োজনীয় অ্যাক্সেস আপনার কাছে থাকবে। OAuth ব্যবহার করে গুগল এপিআই-এর সাথে কাজ করার বিষয়ে বিস্তারিত জানতে ‘Using OAuth 2.0 to Access Google APIs’ দেখুন। উপলব্ধ অপারেশনগুলির জন্য এপিআই রেফারেন্স দেখুন।

সমস্যা সমাধান

OAuth ডায়ালগ অনুপস্থিত

যদি কোনো ব্যবহারকারীর সংস্থা অ্যাপটিকে অনুমোদন দিয়ে থাকে, তাহলে অ্যাপটি অনুমোদন করার সময় সেই সংস্থার ব্যবহারকারীদের OAuth ডায়ালগ দেখানো হবে না। এর একমাত্র ব্যতিক্রম হবে যদি অ্যাপটি এমন অতিরিক্ত Google API স্কোপের জন্য অনুমোদনের অনুরোধ করে যা ওয়ার্কস্পেস অ্যাডমিন কনফিগার করেননি, সেক্ষেত্রে ব্যবহারকারীদের OAuth ডায়ালগটি দেখানো হবে।

ত্রুটি 400: অবৈধ_স্কোপ

যদি কোনো ব্যবহারকারী অ্যাপটি অনুমোদন করার চেষ্টা করার সময় Error 400: invalid_scope বার্তাটি পান, তাহলে বুঝতে হবে যে ব্যবহারকারীর সংস্থা অ্যাপটিকে অনুমোদন করেনি অথবা ভুলভাবে অনুমোদন করেছে । সমস্যাটি সমাধান করার জন্য, ব্যবহারকারীকে তার সংস্থার কাছে অ্যাপটি অনুমোদন করার জন্য অনুরোধ করতে হবে।