আপনার Google Workspace অ্যাড-অন একটি থার্ড-পার্টি পরিষেবার সাথে কানেক্ট করুন

একটি অ্যাড-অনের জন্য একটি সাইন-ইন কার্ড ইন্টারফেস যা তৃতীয় পক্ষের পরিষেবা থেকে লিঙ্কগুলির পূর্বরূপ দেখায়৷

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

এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে ব্যবহারকারীদের অনুমোদনের প্রবাহ (যেমন OAuth) ব্যবহার করে প্রমাণীকরণ করা যায়, যার মধ্যে নিম্নলিখিত পদক্ষেপগুলি অন্তর্ভুক্ত রয়েছে:

1. অনুমোদনের প্রয়োজন হলে সনাক্ত করুন।
2. একটি কার্ড ইন্টারফেস ফেরত দিন যা ব্যবহারকারীদের পরিষেবাতে সাইন ইন করতে অনুরোধ করে।
3. অ্যাড-অন রিফ্রেশ করুন যাতে ব্যবহারকারীরা পরিষেবা বা সুরক্ষিত সংস্থান অ্যাক্সেস করতে পারে।

আপনার অ্যাড-অনের জন্য শুধুমাত্র ব্যবহারকারীর পরিচয়ের প্রয়োজন হলে, আপনি ব্যবহারকারীদের Google Workspace আইডি বা ইমেল ঠিকানা ব্যবহার করে সরাসরি প্রমাণীকরণ করতে পারেন। প্রমাণীকরণের জন্য ইমেল ঠিকানা ব্যবহার করতে, JSON অনুরোধগুলি যাচাই করা দেখুন। আপনি যদি Google Apps স্ক্রিপ্ট ব্যবহার করে আপনার অ্যাড-অন তৈরি করে থাকেন, তাহলে আপনার অ্যাড-অনকে তৃতীয় পক্ষের পরিষেবাতে সংযুক্ত করার বিষয়ে জানতে অ্যাপস স্ক্রিপ্ট ডকুমেন্টেশন দেখুন।

সনাক্ত করুন যে অনুমোদন প্রয়োজন

আপনার অ্যাড-অন ব্যবহার করার সময়, ব্যবহারকারীরা বিভিন্ন কারণে একটি সুরক্ষিত সংস্থান অ্যাক্সেস করার জন্য অনুমোদিত নাও হতে পারে, যেমন নিম্নলিখিত:

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

আপনার অ্যাড-অন এই ক্ষেত্রে সনাক্ত করা উচিত যাতে ব্যবহারকারীরা সাইন ইন করতে এবং আপনার পরিষেবা অ্যাক্সেস করতে পারে।

ব্যবহারকারীদের আপনার পরিষেবাতে সাইন ইন করতে অনুরোধ করুন

যখন আপনার অ্যাড-অন শনাক্ত করে যে অনুমোদনের প্রয়োজন, তখন অ্যাড-অনটিকে অবশ্যই একটি কার্ড ইন্টারফেস ফেরত দিতে হবে যাতে ব্যবহারকারীদের পরিষেবাতে সাইন ইন করতে অনুরোধ জানানো হয়। আপনার পরিকাঠামোতে তৃতীয় পক্ষের প্রমাণীকরণ এবং অনুমোদন প্রক্রিয়া সম্পূর্ণ করতে সাইন-ইন কার্ডটি অবশ্যই ব্যবহারকারীদের পুনর্নির্দেশ করবে।

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

নিশ্চিত করা ব্যবহারকারী আইডি গ্রহণ করার আগে সর্বদা টোকেনের অখণ্ডতা যাচাই করুন ।

একটি সাইন-ইন কার্ড তৈরি করুন এবং ফেরত দিন

আপনার পরিষেবার সাইন-ইন কার্ডের জন্য, আপনি Google-এর মৌলিক অনুমোদন কার্ড ব্যবহার করতে পারেন, অথবা আপনি আপনার প্রতিষ্ঠানের লোগোর মতো অতিরিক্ত তথ্য প্রদর্শন করতে একটি কার্ড কাস্টমাইজ করতে পারেন৷ আপনি যদি আপনার অ্যাড-অন সর্বজনীনভাবে প্রকাশ করেন তবে আপনাকে অবশ্যই একটি কাস্টম কার্ড ব্যবহার করতে হবে৷

মৌলিক অনুমোদন কার্ড

নিম্নলিখিত চিত্রটি Google এর মৌলিক অনুমোদন কার্ডের একটি উদাহরণ দেখায়:

মৌলিক অনুমোদন কার্ড ব্যবহার করতে, নিম্নলিখিত JSON প্রতিক্রিয়া ফেরত দিন:

{
  "basic_authorization_prompt": {
    "authorization_url": "AUTHORIZATION_REDIRECT",
    "resource": "RESOURCE_DISPLAY_NAME"
  }
}

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

• AUTHORIZATION_REDIRECT : ওয়েব অ্যাপের URL যা অনুমোদন পরিচালনা করে।
• RESOURCE_DISPLAY_NAME : সুরক্ষিত সম্পদ বা পরিষেবার জন্য প্রদর্শন নাম। এই নামটি অনুমোদনের প্রম্পটে ব্যবহারকারীর কাছে প্রদর্শিত হয়। উদাহরণস্বরূপ, যদি আপনার RESOURCE_DISPLAY_NAME Example Account হয়, তাহলে প্রম্পটটি বলে "এই অ্যাড-অনটি অতিরিক্ত তথ্য দেখাতে চায়, কিন্তু আপনার উদাহরণ অ্যাকাউন্ট অ্যাক্সেস করার জন্য এটির অনুমোদন প্রয়োজন।"

অনুমোদন সম্পূর্ণ করার পরে, ব্যবহারকারীকে সুরক্ষিত সংস্থান অ্যাক্সেস করতে অ্যাড-অন রিফ্রেশ করতে বলা হয়।

কাস্টম অনুমোদন কার্ড

অনুমোদন প্রম্পট পরিবর্তন করতে, আপনি আপনার পরিষেবার সাইন-ইন অভিজ্ঞতার জন্য একটি কাস্টম কার্ড তৈরি করতে পারেন৷

আপনি যদি আপনার অ্যাড-অন সর্বজনীনভাবে প্রকাশ করেন তবে আপনাকে অবশ্যই একটি কাস্টম অনুমোদন কার্ড ব্যবহার করতে হবে৷ Google Workspace মার্কেটপ্লেসের জন্য প্রকাশনার প্রয়োজনীয়তা সম্পর্কে আরও জানতে, অ্যাপ সম্পর্কে পর্যালোচনা দেখুন।

নিম্নলিখিত চিত্রগুলি একটি অ্যাড-অনের হোমপেজের জন্য একটি উদাহরণ কাস্টম অনুমোদন কার্ড দেখায়৷ কার্ডটিতে একটি লোগো, বিবরণ এবং সাইন-ইন বোতাম রয়েছে:

এই কাস্টম কার্ড উদাহরণ ব্যবহার করতে, নিম্নলিখিত JSON প্রতিক্রিয়া ফেরত দিন:

{
  "custom_authorization_prompt": {
    "action": {
      "navigations": [
        {
          "pushCard": {
            "sections": [
              {
                "widgets": [
                  {
                    "image": {
                      "imageUrl": "LOGO_URL",
                      "altText": "LOGO_ALT_TEXT"
                    }
                  },
                  {
                    "divider": {}
                  },
                  {
                    "textParagraph": {
                      "text": "DESCRIPTION"
                    }
                  },
                  {
                    "buttonList": {
                      "buttons": [
                        {
                          "text": "Sign in",
                          "onClick": {
                            "openLink": {
                              "url": "AUTHORIZATION_REDIRECT",
                              "onClose": "RELOAD",
                              "openAs": "OVERLAY"
                            }
                          },
                          "color": {
                            "red": 0,
                            "green": 0,
                            "blue": 1,
                            "alpha": 1,
                          }
                        }
                      ]
                    }
                  },
                  {
                    "textParagraph": {
                      "text": "TEXT_SIGN_UP"
                    }
                  }
                ]
              }
            ]
          }
        }
      ]
    }
  }
}

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

• LOGO_URL : একটি লোগো বা ছবির URL। একটি সর্বজনীন URL হতে হবে।
• LOGO_ALT_TEXT : লোগো বা ছবির জন্য Alt টেক্সট, যেমন Cymbal Labs Logo ।
• DESCRIPTION : ব্যবহারকারীদের সাইন ইন করার জন্য একটি কল টু অ্যাকশন, যেমন Sign in to get started ।
• সাইন-ইন বোতাম আপডেট করতে:
  • AUTHORIZATION_REDIRECT : ওয়েব অ্যাপের URL যা অনুমোদন পরিচালনা করে।
  • ঐচ্ছিক: বোতামের রঙ পরিবর্তন করতে, color ক্ষেত্রের RGBA ফ্লোট মান আপডেট করুন।
• TEXT_SIGN_UP : একটি পাঠ্য যা ব্যবহারকারীদের একটি অ্যাকাউন্ট তৈরি করতে অনুরোধ করে যদি তাদের একটি না থাকে৷ উদাহরণস্বরূপ, New to Cymbal Labs? <a href=\"https://www.example.com/signup\">Sign up</a> here ।