লুকার স্টুডিও API

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

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

মূল বিষয়: API শুধুমাত্র সেইসব ব্যবহারকারীদের জন্য উপলব্ধ যারা Google Workspace বা Cloud Identity সহ এমন একটি প্রতিষ্ঠানের সাথে সম্পর্কিত।

প্রয়োজনীয়তার ওভারভিউ

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

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

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

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

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

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

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

API সক্রিয় করুন

আপনার প্রকল্পের জন্য একটি API সক্ষম করতে:

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

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

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

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

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

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

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

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

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

1. আপনার Google অ্যাডমিন কনসোলে সাইন ইন করুন এবং ডোমেন-ওয়াইড ডেলিগেশনে নেভিগেট করুন।
2. API clients , নতুন যোগ করুন ক্লিক করুন।
3. অনুমোদনের জন্য অ্যাপটির Client ID লিখুন (অর্থাৎ যে অ্যাপটি লুকার স্টুডিও API ব্যবহার করে)।
4. অ্যাপের জন্য প্রয়োজনীয় সকল OAuth স্কোপ লিখুন। সম্পদ পরিচালনার জন্য Looker Studio API ব্যবহার করলে সাধারণত নিম্নলিখিত স্কোপগুলি অনুরোধ করা হয়:
   • 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 স্কোপ ব্যবহার করার কথা বিবেচনা করুন।

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

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

একবার আপনি অ্যাপটি তৈরি এবং অনুমোদিত করার পরে, Workspace ব্যবহারকারীদের জন্য API কল করার জন্য আপনার প্রয়োজনীয় অ্যাক্সেস থাকবে। OAuth ব্যবহার করে Google API গুলির সাথে কাজ করার বিশদ বিবরণের জন্য Google API গুলি অ্যাক্সেস করতে OAuth 2.0 ব্যবহার দেখুন। উপলব্ধ ক্রিয়াকলাপগুলির জন্য API রেফারেন্সটি দেখুন।

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

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

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

ত্রুটি ৪০০: invalid_scope

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