Google Workspace Marketplace SDK-এ আপনার অ্যাপ কনফিগার করুন

এই পৃষ্ঠায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল ওয়ার্কস্পেস মার্কেটপ্লেসে আপনার অ্যাপ কনফিগার ও পরিচালনা করতে গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে ব্যবহার করতে হয়।

আপনার অ্যাপটি ব্যবহারের জন্য উপলব্ধ করতে, আপনাকে এটি মার্কেটপ্লেস এসডিকে-তে সেট আপ করতে হবে। মার্কেটপ্লেস এসডিকে হলো একটি টুলকিট যা আপনাকে মার্কেটপ্লেসে আপনার অ্যাপ তৈরি এবং নিয়ন্ত্রণ করতে দেয়। আপনি মার্কেটপ্লেস এসডিকে ব্যবহার করে মার্কেটপ্লেসের সেটিংস পরিচালনা করেন, যেমন:

• আপনার অ্যাপটি কোনো নির্দিষ্ট গুগল ওয়ার্কস্পেস অর্গানাইজেশনের জন্য উপলব্ধ (একটি ব্যক্তিগত অ্যাপ), নাকি মার্কেটপ্লেসের সকল ব্যবহারকারীর জন্য উপলব্ধ (একটি পাবলিক অ্যাপ)
• মার্কেটপ্লেসের যে ধরনের ব্যবহারকারীরা আপনার অ্যাপ ইনস্টল করতে পারেন
• আপনার অ্যাপটি কোন Google Workspace অ্যাপ্লিকেশন(গুলি) এর সাথে একীভূত হয়
• আপনার অ্যাপের জন্য প্রয়োজনীয় OAuth স্কোপগুলি
• অ্যাপটি কে তৈরি ও রক্ষণাবেক্ষণ করে সে সম্পর্কিত তথ্য

আপনি আপনার অ্যাপটি ব্যক্তিগতভাবে বা সর্বজনীনভাবে প্রকাশ করুন না কেন, মার্কেটপ্লেসে আপনার অ্যাপটি পরিচালনা করার জন্য আপনাকে অবশ্যই মার্কেটপ্লেস এসডিকে (Marketplace SDK) ব্যবহার করতে হবে।

মার্কেটপ্লেস SDK সক্রিয় করুন

যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে আপনার গুগল ক্লাউড প্রজেক্টে মার্কেটপ্লেস এসডিকে (Marketplace SDK ) সক্রিয় করুন।

গুগল ক্লাউড কনসোলে আপনার ক্লাউড প্রজেক্টটি খুলুন।

যদি আগে থেকে খোলা না থাকে, তাহলে এই স্যাম্পলটির জন্য আপনি যে ক্লাউড প্রজেক্টটি ব্যবহার করতে চান সেটি খুলুন:

1. গুগল ক্লাউড কনসোলে, 'Select a project' পেজে যান।

   একটি ক্লাউড প্রকল্প নির্বাচন করুন

2. আপনি যে গুগল ক্লাউড প্রজেক্টটি ব্যবহার করতে চান, সেটি নির্বাচন করুন। অথবা, 'Create project'-এ ক্লিক করুন এবং স্ক্রিনে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনি যদি একটি গুগল ক্লাউড প্রজেক্ট তৈরি করেন, তাহলে প্রজেক্টটির জন্য বিলিং চালু করার প্রয়োজন হতে পারে।

মার্কেটপ্লেস SDK চালু করুন

• গুগল ক্লাউড কনসোলে, গুগল ওয়ার্কস্পেস মার্কেটপ্লেস এসডিকে সক্রিয় করুন।

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

আপনার অ্যাপের জন্য কনফিগারেশন সেটিংস নির্ধারণ করুন।

নিম্নলিখিত রেফারেন্সে মার্কেটপ্লেস এসডিকে-এর অ্যাপ কনফিগারেশন পৃষ্ঠায় উপলব্ধ সেটিংস বর্ণনা করা হয়েছে।

কারা আপনার অ্যাপ দেখতে ও ইনস্টল করতে পারবে তা বেছে নিন

আপনার অ্যাপ কনফিগার করার সময়, আপনি নিম্নলিখিত সেটিংস ব্যবহার করে সেই ব্যবহারকারীদের নির্দিষ্ট করেন যারা আপনার অ্যাপটি অ্যাক্সেস করতে পারবে:

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

আপনার অ্যাপ তালিকায় আপনি যে সেটিংসই নির্দিষ্ট করুন না কেন, অ্যাডমিনিস্ট্রেটরদের দ্বারা সেট করা সেটিংসের উপর ভিত্তি করে গুগল ওয়ার্কস্পেস অর্গানাইজেশনের অন্তর্ভুক্ত ব্যবহারকারীরা আপনার অ্যাপটি খুঁজে পেতে, ইনস্টল করতে বা ব্যবহার করতে সক্ষম নাও হতে পারেন। অ্যাডমিনিস্ট্রেটররা নিম্নলিখিত উপায়ে আপনার অ্যাপের প্রাপ্যতাকে প্রভাবিত করতে পারেন:

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

অ্যাডমিনিস্ট্রেটররা কীভাবে মার্কেটপ্লেসে অ্যাক্সেস পরিচালনা করেন তা জানতে, মার্কেটপ্লেস অ্যাডমিন হেল্প ডকুমেন্টেশন দেখুন।

অ্যাপের দৃশ্যমানতা সেটিংস

আপনি যদি একটি গুগল ওয়ার্কস্পেস অ্যাকাউন্ট (আপনার কর্মক্ষেত্র বা শিক্ষা প্রতিষ্ঠান দ্বারা তৈরি একটি অ্যাকাউন্ট) ব্যবহার করেন, তাহলে আপনি অ্যাপ ভিজিবিলিটি অপশনটি দেখতে পাবেন। আপনি যদি একটি কনজিউমার অ্যাকাউন্ট (যে অ্যাকাউন্টের শেষে "@gmail.com" থাকে) ব্যবহার করেন, তবে আপনি শুধুমাত্র সর্বজনীনভাবে প্রকাশ করতে পারবেন।

• পাবলিক : আপনার ডোমেইনের বাইরের লোকেরাও অ্যাপটি খুঁজে পেতে এবং ইনস্টল করতে পারবে। আপনি যদি পাবলিক ভিজিবিলিটি বেছে নেন, তাহলে আপনার অ্যাপের তালিকাটি প্রকাশিত হওয়ার আগে গুগল তা পর্যালোচনা ও অনুমোদন করে।
• ব্যক্তিগত : শুধুমাত্র আপনার ডোমেইনের অন্তর্ভুক্ত ব্যক্তিরাই আপনার অ্যাপটি খুঁজে পেতে এবং ইনস্টল করতে পারবেন।

আপনি যদি ‘তালিকাভুক্ত নয়’ হিসেবে প্রকাশ করতে চান, তাহলে অ্যাপটির তালিকা ব্রাউজ বা অনুসন্ধানের ফলাফলে দেখানো হয় না। ব্যবহারকারীরা শুধুমাত্র সরাসরি ইউআরএল (URL) ব্যবহার করে অ্যাপটির স্টোর পেজে প্রবেশ করতে পারেন।

আপনার অ্যাপটি কোন কোন দেশ ও অঞ্চলে পাওয়া যাবে তা যদি সীমিত করতে চান, তাহলে স্টোর লিস্টিং তৈরি করার সময় ডিস্ট্রিবিউশন সেকশনে তা সেট করে নিতে পারেন।

অ্যাপ ইনস্টলেশন সেটিংস

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

• ব্যক্তিগত + অ্যাডমিন ইনস্টল (ডিফল্ট) : অ্যাপটি স্বতন্ত্র ব্যবহারকারীরা অথবা অ্যাডমিনরা তাদের ডোমেইন, সাংগঠনিক ইউনিট বা ব্যবহারকারীদের একটি গ্রুপের জন্য ইনস্টল করতে পারেন। স্বতন্ত্র ইনস্টল সক্ষম করা থাকলেও, একজন ব্যবহারকারীর ডোমেইন পলিসি তাকে অ্যাপটি ইনস্টল করা থেকে বিরত রাখতে পারে।
• শুধুমাত্র অ্যাডমিনদের জন্য ইনস্টল : অ্যাপটি শুধুমাত্র অ্যাডমিনরাই তাদের ডোমেইন, অর্গানাইজেশনাল ইউনিট বা ব্যবহারকারীদের একটি গ্রুপের জন্য ইনস্টল করতে পারবেন। আপনার অ্যাপটি শুধুমাত্র অ্যাডমিন এবং যারা তাদের গুগল অ্যাকাউন্টে লগ ইন করেননি, তাদের জন্য গুগল ওয়ার্কস্পেস মার্কেটপ্লেসের সার্চ রেজাল্টে দেখা যাবে। আপনার অ্যাপের জন্য ডোমেইন ইনস্টলেশনের প্রয়োজন হলে এই অপশনটি বেছে নিন।

সাধারণ ইনস্টলেশন এবং দৃশ্যমানতা সেটিংস

নিম্নলিখিত সারণিতে অ্যাপ ইনস্টলেশন এবং দৃশ্যমানতার জন্য কিছু সাধারণ কনফিগারেশন বিকল্পের সারসংক্ষেপ দেওয়া হলো:

আপনার অ্যাপটি গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশনগুলির সাথে কীভাবে সমন্বিত হয় তা শনাক্ত করুন।

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

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

• Unsaved : আপনি একটি ইন্টিগ্রেশন যোগ বা পরিবর্তন করেছেন, কিন্তু অ্যাপ কনফিগারেশন ট্যাবে পরিবর্তনগুলি সংরক্ষণ করেননি।
• Draft : আপনার পরিবর্তনগুলো সংরক্ষিত হয়েছে কিন্তু প্রকাশিত হয়নি।
• Under review : আপনি পর্যালোচনার জন্য আপনার হালনাগাদ করা অ্যাপ ইন্টিগ্রেশনটি জমা দিয়েছেন।
• Published : আপনার অ্যাপ ইন্টিগ্রেশনটি মার্কেটপ্লেস তালিকায় অন্তর্ভুক্ত করা হয়েছে।

আপনি কোন অ্যাপ ইন্টিগ্রেশনগুলো বেছে নিচ্ছেন তার উপর নির্ভর করে, আপনাকে আরও তথ্য প্রদান করতে এবং আপনার গুগল ক্লাউড প্রজেক্টে প্রাসঙ্গিক এপিআই (API) সক্রিয় করতে হতে পারে। নিচের সারণিতে প্রতিটির জন্য প্রয়োজনীয় অতিরিক্ত সেটআপ বর্ণনা করা হলো:

আপনার অ্যাপের জন্য প্রয়োজনীয় অ্যাক্সেসের স্তর নির্দিষ্ট করুন।

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

আপনি যদি একাধিক অ্যাপ ইন্টিগ্রেশন অন্তর্ভুক্ত করেন, তাহলে মার্কেটপ্লেস SDK অ্যাপ কনফিগারেশন পেজ এবং আপনার OAuth কনসেন্ট স্ক্রিনে প্রত্যেকটির স্কোপ যোগ করা নিশ্চিত করুন।

সর্বদা যথাসম্ভব সংকীর্ণতম স্কোপ ব্যবহার করুন (উদাহরণস্বরূপ, আপনার যদি শুধুমাত্র একটি রিড-অনলি স্কোপের প্রয়োজন হয়, তবে একটি সম্পূর্ণ ড্রাইভ স্কোপ অন্তর্ভুক্ত করবেন না)।

অ্যাপস স্ক্রিপ্ট প্রোজেক্টের ক্ষেত্রে, আরও বিস্তারিত তথ্যের জন্য অথরাইজেশন স্কোপ দেখুন।

অ্যাপ ডেভেলপার সম্পর্কে তথ্য প্রদান করুন।

ডেভেলপার ইনফরমেশন (Developer Information) এর অধীনে যোগাযোগের তথ্য এবং অন্যান্য বিবরণ পূরণ করুন। এই ফিল্ডগুলো আপনার অ্যাপের স্টোর লিস্টিং পেজে দেখা যাবে।

মার্কেটপ্লেস SDK-তে আপনার অ্যাপ কনফিগারেশন সেটিংস সংরক্ষণ করুন।

পূর্ববর্তী অংশের তথ্য ব্যবহার করে মার্কেটপ্লেস SDK-তে আপনার অ্যাপ কনফিগারেশনটি সংরক্ষণ করুন:

1. গুগল ক্লাউড কনসোলে, মার্কেটপ্লেস এসডিকে অ্যাপ কনফিগারেশন পৃষ্ঠায় যান:

   মার্কেটপ্লেস SDK কনফিগারেশন পৃষ্ঠায় যান

2. পূর্ববর্তী বিভাগে আপনি যা নির্ধারণ করেছেন তার উপর ভিত্তি করে প্রতিটি বিভাগ পূরণ করুন।

3. খসড়া সংরক্ষণ করুন- এ ক্লিক করুন।

4. (ঐচ্ছিক) আপনি গুগল অ্যানালিটিক্স- এ অ্যাপ ব্যবহারের বিশ্লেষণ পেতে পারেন। এর জন্য, মার্কেটপ্লেস এসডিকে-তে একটি গুগল অ্যানালিটিক্স আইডি যোগ করুন।

   1. অ্যানালিটিক্স ট্যাবে যান।
   2. আপনার গুগল অ্যানালিটিক্স আইডি প্রবেশ করান।
   3. সংরক্ষণ করুন- এ ক্লিক করুন।

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

এই অংশে আপনি সম্মুখীন হতে পারেন এমন সাধারণ সমস্যাগুলো বর্ণনা করা হয়েছে।

মার্কেটপ্লেসে অ্যাপ প্রকাশ করার সময় প্রয়োজনীয় অনুমতিগুলো অনুপস্থিত রয়েছে।

আপনি মার্কেটপ্লেসে অ্যাপ প্রকাশ করতে পারছেন না, কারণ মার্কেটপ্লেস SDK-এর অ্যাপ কনফিগারেশন পৃষ্ঠায় অ্যাপ্লিকেশনটি কনফিগার করার প্রচেষ্টা নিম্নলিখিত ত্রুটি বার্তার সাথে ব্যর্থ হচ্ছে:

You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update

এই ত্রুটিটি ঘটে যখন মার্কেটপ্লেস এসডিকে এপিআই সক্রিয় থাকে এবং Editor বা Owner ছাড়া অন্য কোনো আইএএম রোল ব্যবহার করা হয়।

ত্রুটিটি সমাধান করতে, নিম্নলিখিত সমাধানগুলির মধ্যে একটি প্রয়োগ করুন:

• প্রজেক্টের মালিককে বলুন, যে অ্যাকাউন্টটির প্রয়োজনীয় অনুমতি নেই, তাকে roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin রোলটি অ্যাসাইন করে দিতে, যাতে তিনি মার্কেটপ্লেস এসডিকে -তে অ্যাপটি কনফিগার ও পরিচালনা করতে পারেন।

• প্রজেক্ট ওনারকে গুগল ক্লাউড কনসোলের IAM & Admin > Roles পেজের মাধ্যমে একটি কাস্টম রোলে অনুপস্থিত পারমিশনগুলো যোগ করতে বলুন। এরপর, যে অ্যাকাউন্টে অনুপস্থিত পারমিশনগুলো রয়েছে, সেটিতে কাস্টম রোলটি অ্যাসাইন করুন।

• অ্যাপ প্রকাশ করার জন্য সাধারণ roles/editor বা roles/owner ব্যবহার করা যেতে পারে। তবে, ' Use IAM securely ' ডকুমেন্টেশনে এটিকে একটি খারাপ অভ্যাস হিসেবে বিবেচনা করা হয়েছে, কারণ এর মাধ্যমে প্রোজেক্টের অন্যান্য রিসোর্সের সম্পাদনার অ্যাক্সেস সহজে সীমাবদ্ধ করা যায় না।