Google JavaScript API রেফারেন্স দিয়ে সাইন ইন করুন

এই রেফারেন্স পৃষ্ঠাটি "সাইন ইন উইথ গুগল জাভাস্ক্রিপ্ট এপিআই" বর্ণনা করে, যা ওয়েব পৃষ্ঠাগুলিতে "সাইন ইন উইথ গুগল" বোতাম বা "ওয়ান ট্যাপ" প্রম্পট প্রদর্শন করতে ব্যবহৃত হয়।

পদ্ধতি: google.accounts.id.initialize

google.accounts.id.initialize পদ্ধতিটি কনফিগারেশন অবজেক্টের উপর ভিত্তি করে Sign In With Google ক্লায়েন্ট শুরু করে। পদ্ধতির নিম্নলিখিত কোড উদাহরণটি দেখুন:

google.accounts.id.initialize(IdConfiguration)

নিচের কোড উদাহরণটি google.accounts.id.initialize পদ্ধতিটি একটি onload ফাংশন সহ প্রয়োগ করে:

<script>
  window.onload = function () {
    google.accounts.id.initialize({
      client_id: 'YOUR_GOOGLE_CLIENT_ID',
      callback: handleCredentialResponse
    });
    google.accounts.id.prompt();
  };
</script>

google.accounts.id.initialize পদ্ধতিটি একটি Sign In With Google ক্লায়েন্ট ইনস্ট্যান্স তৈরি করে যা একই ওয়েব পৃষ্ঠার সমস্ত মডিউল দ্বারা পরোক্ষভাবে ব্যবহার করা যেতে পারে।

• একই ওয়েব পৃষ্ঠায় একাধিক মডিউল (যেমন ওয়ান ট্যাপ, ব্যক্তিগতকৃত বোতাম, প্রত্যাহার ইত্যাদি) ব্যবহার করলেও আপনাকে কেবল একবার google.accounts.id.initialize পদ্ধতিতে কল করতে হবে।
• যদি আপনি google.accounts.id.initialize পদ্ধতিতে একাধিকবার কল করেন, তাহলে শুধুমাত্র শেষ কলের কনফিগারেশনগুলি মনে রাখা এবং ব্যবহার করা হবে।

আপনি যখনই google.accounts.id.initialize পদ্ধতিটি কল করেন তখনই আপনি আসলে কনফিগারেশনগুলি রিসেট করেন এবং একই ওয়েব পৃষ্ঠার পরবর্তী সমস্ত পদ্ধতি অবিলম্বে নতুন কনফিগারেশনগুলি ব্যবহার করে।

ডেটা টাইপ: আইডি কনফিগারেশন

নিম্নলিখিত টেবিলে IdConfiguration ডেটা টাইপের ক্ষেত্র এবং বর্ণনা তালিকাভুক্ত করা হয়েছে:

ক্লায়েন্ট_আইডি

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

রঙ_স্কিম

এই ক্ষেত্রটি হল ওয়ান ট্যাপ প্রম্পটে প্রয়োগ করা রঙের স্কিম। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত সারণীতে উপলব্ধ রঙের স্কিম এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে।

স্বয়ংক্রিয়_নির্বাচন

এই ক্ষেত্রটি নির্ধারণ করে যে কোনও আইডি টোকেন স্বয়ংক্রিয়ভাবে কোনও ব্যবহারকারীর ইন্টারঅ্যাকশন ছাড়াই ফেরত পাঠানো হবে কিনা যখন কেবলমাত্র একটি Google সেশন আপনার অ্যাপকে অনুমোদন করেছে। ডিফল্ট মান হল false । আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

কলব্যাক

এই ক্ষেত্রটি হল জাভাস্ক্রিপ্ট ফাংশন যা ওয়ান ট্যাপ প্রম্পট বা পপ-আপ উইন্ডো থেকে ফিরে আসা আইডি টোকেন পরিচালনা করে। যদি গুগল ওয়ান ট্যাপ বা সাইন ইন উইথ গুগল বোতাম popup ইউএক্স মোড ব্যবহার করা হয় তবে এই বৈশিষ্ট্যটি প্রয়োজন। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

লগইন_ইউরি

এই বৈশিষ্ট্যটি হল আপনার লগইন এন্ডপয়েন্টের URI।

মানটি অবশ্যই OAuth 2.0 ক্লায়েন্টের জন্য অনুমোদিত রিডাইরেক্ট URI-এর সাথে হুবহু মিলতে হবে, যা আপনি Google ক্লাউড কনসোলে কনফিগার করেছেন এবং আমাদের রিডাইরেক্ট URI যাচাইকরণ নিয়ম মেনে চলতে হবে।

যদি বর্তমান পৃষ্ঠাটি আপনার লগইন পৃষ্ঠা হয় তবে এই বৈশিষ্ট্যটি বাদ দেওয়া হতে পারে, এই ক্ষেত্রে শংসাপত্রটি ডিফল্টরূপে এই পৃষ্ঠায় পোস্ট করা হয়।

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

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

আপনার লগইন এন্ডপয়েন্টকে অবশ্যই POST অনুরোধগুলি পরিচালনা করতে হবে যাতে একটি credential প্যারামিটার থাকে যার বডিতে একটি ID টোকেন মান থাকে।

নেটিভ_কলব্যাক

এই ক্ষেত্রটি জাভাস্ক্রিপ্ট ফাংশনের নাম যা ব্রাউজারের বিল্ট-ইন ক্রেডেনশিয়াল ম্যানেজার থেকে ফিরে আসা পাসওয়ার্ড ক্রেডেনশিয়াল পরিচালনা করে। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

বাইরে_ট্যাপ_করে_বাতিল করুন

এই ক্ষেত্রটি নির্ধারণ করে যে ব্যবহারকারী প্রম্পটের বাইরে ক্লিক করলে ওয়ান ট্যাপ অনুরোধ বাতিল করা হবে কিনা। ডিফল্ট মান হল true । আপনি যদি মানটি false তে সেট করেন তবে আপনি এটি অক্ষম করতে পারেন। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

প্রম্পট_প্যারেন্ট_আইডি

এই বৈশিষ্ট্যটি কন্টেইনার উপাদানের DOM ID সেট করে। যদি এটি সেট না করা থাকে, তাহলে উইন্ডোর উপরের ডানদিকের কোণায় One Tap প্রম্পট প্রদর্শিত হবে। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

না

এই ক্ষেত্রটি একটি র‍্যান্ডম স্ট্রিং যা আইডি টোকেন দ্বারা রিপ্লে আক্রমণ প্রতিরোধ করার জন্য ব্যবহৃত হয়। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নন্সের দৈর্ঘ্য আপনার পরিবেশ দ্বারা সমর্থিত সর্বোচ্চ JWT আকার এবং পৃথক ব্রাউজার এবং সার্ভার HTTP আকারের সীমাবদ্ধতার মধ্যে সীমাবদ্ধ।

প্রেক্ষাপট

এই ক্ষেত্রটি ওয়ান ট্যাপ প্রম্পটে প্রদর্শিত শিরোনাম এবং বার্তাগুলির পাঠ্য পরিবর্তন করে, ITP ব্রাউজারগুলির জন্য কোনও প্রভাব ফেলে না। ডিফল্টভাবে signin ।

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত সারণীতে সমস্ত উপলব্ধ প্রসঙ্গ এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে:

স্টেট_কুকি_ডোমেন

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

ux_mode সম্পর্কে

"সাইন ইন উইথ গুগল" বোতামটি দ্বারা ব্যবহৃত UX প্রবাহ সেট করতে এই ক্ষেত্রটি ব্যবহার করুন। ডিফল্ট মান হল popup । এই বৈশিষ্ট্যটি OneTap UX-এর উপর কোনও প্রভাব ফেলে না। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত টেবিলে উপলব্ধ UX মোড এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে।

অনুমোদিত_প্যারেন্ট_অরিজিন

মধ্যবর্তী আইফ্রেম এম্বেড করার জন্য অনুমোদিত অরিজিনগুলি। এই ক্ষেত্রটি উপস্থিত থাকলে ওয়ান ট্যাপ মধ্যবর্তী আইফ্রেম মোডে চলে। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত সারণীতে সমর্থিত মানের ধরণ এবং তাদের বিবরণ তালিকাভুক্ত করা হয়েছে।

ওয়াইল্ডকার্ড প্রিফিক্সগুলিও সমর্থিত। উদাহরণস্বরূপ, "https://*.example.com" example.com এবং এর সাবডোমেনগুলির সাথে সকল স্তরের (যেমন news.example.com , login.news.example.com ) মিলিত হয়। ওয়াইল্ডকার্ড ব্যবহার করার সময় যে বিষয়গুলি মনে রাখতে হবে:

• প্যাটার্ন স্ট্রিংগুলি কেবল একটি ওয়াইল্ডকার্ড এবং একটি শীর্ষ স্তরের ডোমেন দিয়ে তৈরি করা যাবে না। উদাহরণস্বরূপ https:// .com এবং https:// .co.uk অবৈধ কারণ "https:// .example.com" example.com এবং এর সমস্ত সাবডোমেনের সাথে মেলে। দুটি ভিন্ন ডোমেন উপস্থাপন করতে কমা দ্বারা পৃথক তালিকা ব্যবহার করুন। উদাহরণস্বরূপ, "https://example1.com,https:// .example2.com" example1.com , example2.com এবং example2.com এর সাবডোমেনের সাথে মেলে।
• ওয়াইল্ডকার্ড ডোমেনগুলি অবশ্যই একটি নিরাপদ https:// স্কিম দিয়ে শুরু হতে হবে, তাই "*.example.com" অবৈধ বলে বিবেচিত হবে।

যদি allowed_parent_origin ফিল্ডের মান অবৈধ হয়, তাহলে মধ্যবর্তী আইফ্রেম মোডের ওয়ান ট্যাপ ইনিশিয়ালাইজেশন ব্যর্থ হবে এবং বন্ধ হয়ে যাবে।

ইন্টারমিডিয়েট_আইফ্রেম_ক্লোজ_কলব্যাক

ব্যবহারকারীরা যখন One Tap UI-তে 'X' বোতামে ট্যাপ করে ম্যানুয়ালি One Tap বন্ধ করে তখন ডিফল্ট ইন্টারমিডিয়েট আইফ্রেম আচরণকে ওভাররাইড করে। ডিফল্ট আচরণ হল DOM থেকে অবিলম্বে ইন্টারমিডিয়েট আইফ্রেমটি সরিয়ে ফেলা।

intermediate_iframe_close_callback ফিল্ডটি শুধুমাত্র মধ্যবর্তী iframe মোডে কার্যকর হয়। এবং এটি One Tap iframe এর পরিবর্তে শুধুমাত্র মধ্যবর্তী iframe এর উপর প্রভাব ফেলে। কলব্যাক আহ্বান করার আগে One Tap UI সরানো হয়।

আইটিপি_সাপোর্ট

এই ক্ষেত্রটি নির্ধারণ করে যে ইন্টেলিজেন্ট ট্র্যাকিং প্রিভেনশন (ITP) সমর্থনকারী ব্রাউজারগুলিতে আপগ্রেড করা One Tap UX সক্ষম করা উচিত কিনা। ডিফল্ট মান হল false । আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

লগইন_ইঙ্গিত

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

আরও তথ্যের জন্য, OpenID Connect ডকুমেন্টেশনে login_hint ক্ষেত্রটি দেখুন।

এইচডি

যখন একজন ব্যবহারকারীর একাধিক অ্যাকাউন্ট থাকে এবং শুধুমাত্র তাদের Workspace অ্যাকাউন্ট দিয়ে সাইন-ইন করা উচিত, তখন Google-কে একটি ডোমেন নামের ইঙ্গিত দেওয়ার জন্য এটি ব্যবহার করুন। সফল হলে, অ্যাকাউন্ট নির্বাচনের সময় প্রদর্শিত ব্যবহারকারীর অ্যাকাউন্টগুলি প্রদত্ত ডোমেনের মধ্যে সীমাবদ্ধ থাকে। একটি ওয়াইল্ডকার্ড মান: * ব্যবহারকারীকে শুধুমাত্র Workspace অ্যাকাউন্ট অফার করে এবং অ্যাকাউন্ট নির্বাচনের সময় গ্রাহক অ্যাকাউন্টগুলি (user@gmail.com) বাদ দেয়।

আরও তথ্যের জন্য, OpenID Connect ডকুমেন্টেশনের hd ক্ষেত্রটি দেখুন।

প্রম্পটের জন্য_ফেডসিএম_ব্যবহার করুন

ব্রাউজারকে ব্যবহারকারীর সাইন-ইন প্রম্পট নিয়ন্ত্রণ করতে এবং আপনার ওয়েবসাইট এবং Google এর মধ্যে সাইন-ইন প্রবাহের মধ্যস্থতা করতে অনুমতি দিন। ডিফল্টভাবে মিথ্যা। আরও তথ্যের জন্য FedCM পৃষ্ঠায় মাইগ্রেট করুন দেখুন।

বোতামের জন্য_fedcm_ব্যবহার করুন

এই ক্ষেত্রটি নির্ধারণ করে যে Chrome (ডেস্কটপ M125+ এবং Android M128+) এ FedCM বোতাম UX ব্যবহার করা উচিত কিনা। ডিফল্টভাবে false হিসেবে সেট করা আছে। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

বোতাম_স্বয়ংক্রিয়_নির্বাচন

এই ক্ষেত্রটি FedCM বোতাম প্রবাহের জন্য স্বয়ংক্রিয় নির্বাচন বিকল্পটি সক্ষম করবে কিনা তা নির্ধারণ করে। যদি সক্ষম করা থাকে, তাহলে সক্রিয় Google সেশন সহ ফিরে আসা ব্যবহারকারীরা অ্যাকাউন্ট চয়নকারী প্রম্পটটি বাইপাস করে স্বয়ংক্রিয়ভাবে সাইন ইন করবেন। ডিফল্টভাবে false হবে। অপ্ট-ইন লঞ্চের সময় আপনাকে স্পষ্টভাবে বোতাম স্বয়ংক্রিয়-সাইন-ইন সক্ষম করতে হবে। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

পদ্ধতি: google.accounts.id.prompt

initialize() পদ্ধতিটি চালু করার পরে google.accounts.id.prompt পদ্ধতিটি One Tap প্রম্পট অথবা ব্রাউজার বিল্ট-ইন ক্রেডেনশিয়াল ম্যানেজার প্রদর্শন করে। পদ্ধতিটির নিম্নলিখিত কোড উদাহরণটি দেখুন:

 google.accounts.id.prompt(/**
 @type{(function(!PromptMomentNotification):void)=} */ momentListener)

সাধারণত, পৃষ্ঠা লোডের সময় prompt() পদ্ধতিটি কল করা হয়। গুগলের সেশন স্ট্যাটাস এবং ব্যবহারকারীর সেটিংসের কারণে, ওয়ান ট্যাপ প্রম্পট UI প্রদর্শিত নাও হতে পারে। বিভিন্ন মুহূর্তের জন্য UI স্ট্যাটাস সম্পর্কে বিজ্ঞপ্তি পেতে, UI স্ট্যাটাস বিজ্ঞপ্তিগুলি পাওয়ার জন্য একটি ফাংশন পাস করুন।

নিম্নলিখিত মুহুর্তে বিজ্ঞপ্তিগুলি পাঠানো হয়:

• ডিসপ্লে মোমেন্ট: prompt() মেথড কল করার পরে এটি ঘটে। নোটিফিকেশনে একটি বুলিয়ান মান থাকে যা UI প্রদর্শিত হচ্ছে কিনা তা নির্দেশ করে।

• বাদ দেওয়া মুহূর্ত: এটি তখন ঘটে যখন ওয়ান ট্যাপ প্রম্পটটি স্বয়ংক্রিয় বাতিল, ম্যানুয়াল বাতিলের মাধ্যমে বন্ধ হয়ে যায়, অথবা যখন Google কোনও শংসাপত্র জারি করতে ব্যর্থ হয়, যেমন যখন নির্বাচিত সেশনটি Google থেকে সাইন আউট হয়ে যায়।

  এই ক্ষেত্রে, আমরা আপনাকে পরবর্তী পরিচয় প্রদানকারীদের সাথে যোগাযোগ করার পরামর্শ দিচ্ছি, যদি থাকে।

• খারিজ করা মুহূর্ত: এটি তখন ঘটে যখন গুগল সফলভাবে একটি শংসাপত্র পুনরুদ্ধার করে অথবা কোনও ব্যবহারকারী শংসাপত্র পুনরুদ্ধার প্রবাহ বন্ধ করতে চায়। উদাহরণস্বরূপ, যখন ব্যবহারকারী আপনার লগইন ডায়ালগে তাদের ব্যবহারকারীর নাম এবং পাসওয়ার্ড ইনপুট করতে শুরু করে, তখন আপনি google.accounts.id.cancel() পদ্ধতিতে কল করে One Tap প্রম্পট বন্ধ করতে পারেন এবং একটি খারিজ করা মুহূর্ত ট্রিগার করতে পারেন।

নিম্নলিখিত কোড উদাহরণটি স্কিপড মুহূর্তটি বাস্তবায়ন করে:

<script>
  window.onload = function () {
    google.accounts.id.initialize(...);
    google.accounts.id.prompt((notification) => {
      if (notification.isNotDisplayed() || notification.isSkippedMoment()) {
        // continue with another identity provider.
      }
    });
  };
</script>

ডেটা টাইপ: প্রম্পটমোমেন্টনোটিফিকেশন

নিম্নলিখিত টেবিলে PromptMomentNotification ডেটা টাইপের পদ্ধতি এবং বর্ণনা তালিকাভুক্ত করা হয়েছে:

ডেটা টাইপ: ক্রেডেনশিয়াল রেসপন্স

যখন আপনার callback ফাংশনটি চালু করা হয়, তখন একটি CredentialResponse অবজেক্ট প্যারামিটার হিসেবে পাস করা হয়। নিম্নলিখিত টেবিলে ক্রেডেনশিয়াল রেসপন্স অবজেক্টের মধ্যে থাকা ক্ষেত্রগুলি তালিকাভুক্ত করা হয়েছে:

শংসাপত্র

এই ক্ষেত্রটি হল একটি বেস৬৪-এনকোডেড JSON ওয়েব টোকেন (JWT) স্ট্রিং হিসেবে ID টোকেন।

ডিকোড করা হলে, JWT নিম্নলিখিত উদাহরণের মতো দেখায়:

header
{
  "alg": "RS256",
  "kid": "f05415b13acb9590f70df862765c655f5a7a019e", // JWT signature
  "typ": "JWT"
}
payload
{
  "iss": "https://accounts.google.com", // The JWT's issuer
  "nbf":  161803398874,
  "aud": "314159265-pi.apps.googleusercontent.com", // Your server's client ID
  "sub": "3141592653589793238", // The unique ID of the user's Google Account
  "hd": "gmail.com", // If present, the host domain of the user's GSuite email address
  "email": "elisa.g.beckett@gmail.com", // The user's email address
  "email_verified": true, // true, if Google has verified the email address
  "azp": "314159265-pi.apps.googleusercontent.com",
  "name": "Elisa Beckett",
                            // If present, a URL to user's profile picture
  "picture": "https://lh3.googleusercontent.com/a-/e2718281828459045235360uler",
  "given_name": "Elisa",
  "family_name": "Beckett",
  "iat": 1596474000, // Unix timestamp of the assertion's creation time
  "exp": 1596477600, // Unix timestamp of the assertion's expiration time
  "jti": "abc161803398874def"
}

sub গুগল অ্যাকাউন্টের জন্য একটি বিশ্বব্যাপী অনন্য শনাক্তকারী। ব্যবহারকারীর জন্য শনাক্তকারী হিসাবে শুধুমাত্র sub ব্যবহার করুন কারণ এটি সমস্ত গুগল অ্যাকাউন্টের মধ্যে অনন্য এবং কখনও পুনঃব্যবহৃত হয় না।

email , email_verified এবং hd ফিল্ড ব্যবহার করে আপনি নির্ধারণ করতে পারবেন যে Google কোন ইমেল ঠিকানা হোস্ট করে এবং এর জন্য অনুমোদিত কিনা। যেসব ক্ষেত্রে Google অনুমোদিত, সেই ব্যবহারকারীকে বৈধ অ্যাকাউন্টের মালিক হিসেবে নিশ্চিত করা হয়।

যেসব ক্ষেত্রে গুগল কর্তৃত্বপূর্ণ:

• email @gmail.com প্রত্যয় আছে, এটি একটি জিমেইল অ্যাকাউন্ট।
• email_verified সত্য এবং hd সেট করা আছে, এটি একটি Google Workspace অ্যাকাউন্ট।

ব্যবহারকারীরা Gmail বা Google Workspace ব্যবহার না করেই Google অ্যাকাউন্টের জন্য নিবন্ধন করতে পারেন। যখন email @gmail.com প্রত্যয় না থাকে এবং hd অনুপস্থিত থাকে, তখন Google অনুমোদিত নয় এবং ব্যবহারকারীকে যাচাই করার জন্য পাসওয়ার্ড বা অন্যান্য চ্যালেঞ্জ পদ্ধতি সুপারিশ করা হয়। email_verfied ও সত্য হতে পারে কারণ Google অ্যাকাউন্ট তৈরি করার সময় Google প্রাথমিকভাবে ব্যবহারকারীকে যাচাই করেছিল, তবে তৃতীয় পক্ষের ইমেল অ্যাকাউন্টের মালিকানা তখন থেকে পরিবর্তিত হতে পারে।

exp ফিল্ডটি আপনার সার্ভার সাইডে টোকেন যাচাই করার জন্য মেয়াদোত্তীর্ণ সময় দেখায়। Sign In With Google থেকে প্রাপ্ত ID টোকেনের জন্য এক ঘন্টা সময় লাগে। মেয়াদোত্তীর্ণ সময়ের আগে আপনাকে টোকেনটি যাচাই করতে হবে। সেশন পরিচালনার জন্য exp ব্যবহার করবেন না । মেয়াদোত্তীর্ণ ID টোকেন মানে ব্যবহারকারী সাইন আউট হয়ে গেছেন তা নয় । আপনার অ্যাপ আপনার ব্যবহারকারীদের সেশন পরিচালনার জন্য দায়ী।

নির্বাচন করুন

নিচের টেবিলে select_by ফিল্ডের সম্ভাব্য মানগুলি তালিকাভুক্ত করা হয়েছে। মান সেট করতে সেশন এবং সম্মতির অবস্থা সহ ব্যবহৃত বোতামের ধরণ ব্যবহার করা হয়,

• ব্যবহারকারী "One Tap" অথবা "Sign In With Google" বোতাম টিপতেন অথবা স্পর্শহীন স্বয়ংক্রিয় সাইন-ইন প্রক্রিয়া ব্যবহার করতেন।

• একটি বিদ্যমান সেশন পাওয়া গেছে, অথবা ব্যবহারকারী একটি নতুন সেশন স্থাপন করার জন্য একটি Google অ্যাকাউন্ট নির্বাচন করে সাইন-ইন করেছেন।

• আপনার অ্যাপের সাথে আইডি টোকেন শংসাপত্রগুলি ভাগ করার আগে ব্যবহারকারী হয়

  • শংসাপত্র ভাগ করে নেওয়ার জন্য তাদের সম্মতি প্রদানের জন্য নিশ্চিতকরণ বোতাম টিপুন, অথবা
  • পূর্বে সম্মতি দিয়েছিলেন এবং একটি Google অ্যাকাউন্ট বেছে নিতে "একটি অ্যাকাউন্ট নির্বাচন করুন" ব্যবহার করেছিলেন।

এই ক্ষেত্রের মান এই ধরণের যেকোনো একটিতে সেট করা আছে,

অবস্থা

এই ক্ষেত্রটি কেবল তখনই সংজ্ঞায়িত করা হয় যখন ব্যবহারকারী সাইন ইন করার জন্য "Google দিয়ে সাইন ইন করুন" বোতামে ক্লিক করেন এবং ক্লিক করা বোতামের state অ্যাট্রিবিউট নির্দিষ্ট করা হয়। এই ক্ষেত্রের মানটি বোতামের state অ্যাট্রিবিউটে আপনি যে মানটি নির্দিষ্ট করেছেন তার একই মান।

যেহেতু একই পৃষ্ঠায় একাধিক সাইন ইন উইথ গুগল বোতাম রেন্ডার করা যেতে পারে, তাই আপনি প্রতিটি বোতামকে একটি অনন্য স্ট্রিং দিয়ে বরাদ্দ করতে পারেন। অতএব, আপনি এই state ফিল্ডটি সনাক্ত করতে পারেন যে ব্যবহারকারী কোন বোতামে সাইন ইন করতে ক্লিক করেছেন।

পদ্ধতি: google.accounts.id.renderButton

google.accounts.id.renderButton পদ্ধতিটি আপনার ওয়েব পৃষ্ঠাগুলিতে একটি "Google দিয়ে সাইন ইন করুন" বোতাম রেন্ডার করে।

পদ্ধতিটির নিম্নলিখিত কোড উদাহরণটি দেখুন:

google.accounts.id.renderButton(
      /** @type{!HTMLElement} */ parent,
      /** @type{!GsiButtonConfiguration} */ options
    )

ডেটা টাইপ: GsiButtonConfiguration

নিম্নলিখিত টেবিলে GsiButtonConfiguration ডেটা টাইপের ক্ষেত্র এবং বর্ণনা তালিকাভুক্ত করা হয়েছে:

বৈশিষ্ট্যের ধরণ

নিম্নলিখিত বিভাগগুলিতে প্রতিটি বৈশিষ্ট্যের ধরণ এবং একটি উদাহরণ সম্পর্কে বিশদ বিবরণ রয়েছে।

টাইপ করুন

বোতামের ধরণ। ডিফল্ট মান হল standard ।

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত টেবিলে উপলব্ধ বোতামের ধরণ এবং তাদের বিবরণ তালিকাভুক্ত করা হয়েছে:

আদর্শ
standard
icon

থিম

বোতাম থিম। ডিফল্ট মান হল outline । আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত সারণীতে উপলব্ধ থিম এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে:

থিম
outline
filled_blue
filled_black

আকার

বোতামের আকার। ডিফল্ট মানটি large । আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত টেবিলে উপলব্ধ বোতামের আকার এবং তাদের বিবরণ তালিকাভুক্ত করা হয়েছে:

আকার
large
medium
small

টেক্সট

বোতামের টেক্সট। ডিফল্ট মান হল signin_with । বিভিন্ন text অ্যাট্রিবিউট থাকা আইকন বোতামগুলির টেক্সটের জন্য কোনও ভিজ্যুয়াল পার্থক্য নেই। একমাত্র ব্যতিক্রম হল যখন স্ক্রিন অ্যাক্সেসিবিলিটির জন্য টেক্সটটি পড়া হয়।

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত টেবিলে সমস্ত উপলব্ধ বোতাম টেক্সট এবং তাদের বিবরণ তালিকাভুক্ত করা হয়েছে:

টেক্সট
signin_with
signup_with
continue_with
signin

আকৃতি

বোতামের আকৃতি। ডিফল্ট মান rectangular । আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত টেবিলে উপলব্ধ বোতামের আকার এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে:

আকৃতি
rectangular
pill
circle
square

লোগো_সারিবদ্ধকরণ

গুগল লোগোর সারিবদ্ধকরণ। ডিফল্ট মানটি left আছে। এই বৈশিষ্ট্যটি শুধুমাত্র standard বোতামের ধরণের ক্ষেত্রে প্রযোজ্য। আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

নিম্নলিখিত সারণীতে উপলব্ধ সারিবদ্ধকরণ এবং তাদের বর্ণনা তালিকাভুক্ত করা হয়েছে:

লোগো_সারিবদ্ধকরণ
left
center

প্রস্থ

পিক্সেলে সর্বনিম্ন বোতামের প্রস্থ। সর্বোচ্চ প্রস্থ ৪০০ পিক্সেল।

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

লোকেল

ঐচ্ছিক। নির্দিষ্ট লোকেল ব্যবহার করে বোতামের টেক্সট প্রদর্শন করুন, অন্যথায় ব্যবহারকারীর Google অ্যাকাউন্ট বা ব্রাউজার সেটিংসে ডিফল্ট। লাইব্রেরি লোড করার সময় src নির্দেশিকায় hl প্যারামিটার এবং ভাষা কোড যোগ করুন, উদাহরণস্বরূপ: gsi/client?hl=<iso-639-code> ।

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

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

ক্লিক_লিসনার

click_listener অ্যাট্রিবিউট ব্যবহার করে Sign in with Google বোতামে ক্লিক করলে যে JavaScript ফাংশনটি কল করা হবে তা আপনি সংজ্ঞায়িত করতে পারেন।

  google.accounts.id.renderButton(document.getElementById("signinDiv"), {
      theme: 'outline',
      size: 'large',
      click_listener: onClickHandler
    });

  
  function onClickHandler(){
    console.log("Sign in with Google button clicked...")
  }
  

এই উদাহরণে, Sign In with Google বোতামে ক্লিক করা হলে Sign In with Google বোতামে ক্লিক করা হয়েছে... বার্তাটি কনসোলে লগ করা হয়।

অবস্থা

ঐচ্ছিক, যেহেতু একই পৃষ্ঠায় একাধিক "Google দিয়ে সাইন ইন করুন" বোতাম রেন্ডার করা যেতে পারে, তাই আপনি প্রতিটি বোতামকে একটি অনন্য স্ট্রিং দিয়ে বরাদ্দ করতে পারেন। একই স্ট্রিংটি আইডি টোকেনের সাথে ফিরে আসবে, যাতে আপনি সনাক্ত করতে পারেন যে কোন বোতাম ব্যবহারকারী সাইন ইন করতে ক্লিক করেছেন।

আরও তথ্যের জন্য নিম্নলিখিত টেবিলটি দেখুন:

ডেটা টাইপ: শংসাপত্র

যখন আপনার native_callback ফাংশনটি চালু করা হয়, তখন একটি Credential অবজেক্ট প্যারামিটার হিসেবে পাস করা হয়। নিম্নলিখিত টেবিলে অবজেক্টের মধ্যে থাকা ক্ষেত্রগুলি তালিকাভুক্ত করা হয়েছে:

পদ্ধতি: google.accounts.id.disableAutoSelect

যখন ব্যবহারকারী আপনার ওয়েবসাইট থেকে সাইন আউট করেন, তখন কুকিতে স্ট্যাটাস রেকর্ড করার জন্য আপনাকে google.accounts.id.disableAutoSelect পদ্ধতিটি কল করতে হবে। এটি UX ডেড লুপ প্রতিরোধ করে। পদ্ধতির নিম্নলিখিত কোড স্নিপেটটি দেখুন:

google.accounts.id.disableAutoSelect()

নিচের কোড উদাহরণটি google.accounts.id.disableAutoSelect পদ্ধতিটি onSignout() ফাংশন সহ প্রয়োগ করে:

<script>
  function onSignout() {
    google.accounts.id.disableAutoSelect();
  }
</script>

পদ্ধতি: google.accounts.id.storeCredential

এই পদ্ধতিটি ব্রাউজারের বিল্ট-ইন ক্রেডেনশিয়াল ম্যানেজার API-এর store() পদ্ধতির জন্য একটি র‍্যাপার। অতএব, এটি শুধুমাত্র একটি পাসওয়ার্ড ক্রেডেনশিয়াল সংরক্ষণ করতে ব্যবহার করা যেতে পারে। পদ্ধতির নিম্নলিখিত কোড উদাহরণটি দেখুন:

google.accounts.id.storeCredential(Credential, callback)

নিচের কোড উদাহরণটি onSignIn() ফাংশন সহ google.accounts.id.storeCredential পদ্ধতি প্রয়োগ করে:

<script>
  function onSignIn() {
    let cred = {id: '...', password: '...'};
    google.accounts.id.storeCredential(cred);
  }
</script>

পদ্ধতি: google.accounts.id.cancel

নির্ভরশীল পক্ষ DOM থেকে প্রম্পটটি সরিয়ে ফেললে আপনি One Tap ফ্লো বাতিল করতে পারবেন। যদি কোনও শংসাপত্র ইতিমধ্যেই নির্বাচিত থাকে তবে বাতিলকরণ অপারেশনটি উপেক্ষা করা হয়। পদ্ধতির নিম্নলিখিত কোড উদাহরণটি দেখুন:

google.accounts.id.cancel()

নিচের কোড উদাহরণটি onNextButtonClicked() ফাংশন সহ google.accounts.id.cancel() পদ্ধতি প্রয়োগ করে:

<script>
  function onNextButtonClicked() {
    google.accounts.id.cancel();
    showPasswordPage();
  }
</script>

লাইব্রেরি লোড কলব্যাক: onGoogleLibraryLoad

আপনি onGoogleLibraryLoad কলব্যাক নিবন্ধন করতে পারেন। Sign In With Google JavaScript লাইব্রেরি লোড হওয়ার পরে এটি জানানো হবে:

window.onGoogleLibraryLoad = () => {
    ...
};

এই কলব্যাকটি window.onload কলব্যাকের জন্য একটি শর্টকাট মাত্র। আচরণে কোনও পার্থক্য নেই।

নিম্নলিখিত কোড উদাহরণটি একটি onGoogleLibraryLoad কলব্যাক বাস্তবায়ন করে:

<script>
  window.onGoogleLibraryLoad = () => {
   google.accounts.id.initialize({
     ...
   });
   google.accounts.id.prompt();
  };
</script>

পদ্ধতি: google.accounts.id.revoke

google.accounts.id.revoke পদ্ধতিটি নির্দিষ্ট ব্যবহারকারীর জন্য আইডি টোকেন ভাগ করে নেওয়ার জন্য ব্যবহৃত OAuth অনুদান প্রত্যাহার করে। পদ্ধতির নিম্নলিখিত কোড স্নিপেটটি দেখুন: javascript google.accounts.id.revoke(login_hint, callback)

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি আইডি দিয়ে revoke পদ্ধতি ব্যবহার করতে হয়।

  google.accounts.id.revoke('1618033988749895', done => {
    console.log(done.error);
  });

ডেটা টাইপ: প্রত্যাহারপ্রতিক্রিয়া

যখন আপনার callback ফাংশনটি চালু করা হয়, তখন একটি RevocationResponse অবজেক্ট প্যারামিটার হিসেবে পাস করা হয়। নিম্নলিখিত টেবিলে রিভোকেশন রেসপন্স অবজেক্টের মধ্যে থাকা ক্ষেত্রগুলি তালিকাভুক্ত করা হয়েছে:

সফল

এই ক্ষেত্রটি একটি বুলিয়ান মান যা প্রত্যাহার পদ্ধতি কল সফল হলে সত্য অথবা ব্যর্থ হলে মিথ্যা হিসেবে সেট করা হয়।

ত্রুটি

এই ক্ষেত্রটি একটি স্ট্রিং মান এবং এতে একটি বিস্তারিত ত্রুটি বার্তা রয়েছে যদি প্রত্যাহার পদ্ধতি কল ব্যর্থ হয়, এটি সাফল্যের উপর অনির্ধারিত।