Google Identity Services-এ মাইগ্রেট করা

এক নজরে

Google API কল করার জন্য ব্যবহারকারী প্রতি অ্যাক্সেস টোকেন পেতে, Google একাধিক JavaScript লাইব্রেরি অফার করে:

এই নির্দেশিকা এইসব লাইব্রেরি থেকে Google Identity Services লাইব্রেরিতে মাইগ্রেট করার নির্দেশাবলী প্রদান করে।

এই নির্দেশিকা অনুসরণ করে, আপনি:

  • পুরনো প্ল্যাটফর্ম লাইব্রেরির পরিবর্তে Identity Services লাইব্রেরি ব্যবহার করুন, এবং
  • API ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, বন্ধ হয়ে যাওয়া gapi.auth2 মডিউল, তার পদ্ধতি ও অবজেক্ট সরিয়ে দিন এবং তার পরিবর্তে Identity Services-এর সমতুল্য কিছু ব্যবহার করুন।

Identity Services জাভাস্ক্রিপ্ট লাইব্রেরিতে কী কী পরিবর্তন হয়েছে তার বিবরণ জানতে, এক নজরে এবং ব্যবহারকারীর অনুমোদন কীভাবে কাজ করে পড়ুন, যাতে মূল শব্দ ও ধারণা পর্যালোচনা করতে পারেন।

আপনি যদি ব্যবহারকারীর সাইন-আপ এবং সাইন-ইন করার জন্য যাচাইকরণ খুঁজছেন, তাহলে এর পরিবর্তে Google Sign-In থেকে মাইগ্রেট করা দেখুন।

আপনার অনুমোদনের ফ্লো শনাক্ত করা

ব্যবহারকারীর অনুমোদনের জন্য দুটি সম্ভাব্য ফ্লো আছে: ইমপ্লিসিট এবং অথরাইজেশন কোড।

কোন ধরনের অথরাইজেশন ফ্লো ব্যবহার করা হচ্ছে তা শনাক্ত করতে আপনার ওয়েব অ্যাপ পর্যালোচনা করুন।

আপনার ওয়েব অ্যাপ ইমপ্লিসিট ফ্লো ব্যবহার করছে কিনা তা বোঝার উপায়:

  • আপনার ওয়েব অ্যাপ সম্পূর্ণভাবে ব্রাউজার ভিত্তিক, কোনও ব্যাকএন্ড প্ল্যাটফর্ম নেই।
  • Google API কল করার জন্য ব্যবহারকারীকে উপস্থিত থাকতে হবে, আপনার অ্যাপ শুধুমাত্র অ্যাক্সেস টোকেন ব্যবহার করে এবং রিফ্রেশ টোকেনের প্রয়োজন হয় না।
  • আপনার ওয়েব অ্যাপ apis.google.com/js/api.js লোড করে।
  • আপনার ইমপ্লিমেন্টেশন ক্লায়েন্ট-সাইড ওয়েব অ্যাপ্লিকেশনের জন্য OAuth 2.0-এর উপর ভিত্তি করে তৈরি।
  • আপনার অ্যাপ gapi.client বা gapi.auth2 মডিউল ব্যবহার করে যা JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি-তে পাওয়া যায়।

আপনার ওয়েব অ্যাপ যে অথরাইজেশন কোডের ফ্লো ব্যবহার করছে তার ইঙ্গিত:

  • আপনার প্রয়োগ এর উপর ভিত্তি করে:

  • আপনার অ্যাপ ব্যবহারকারীর ব্রাউজার এবং আপনার ব্যাকএন্ড প্ল্যাটফর্ম, দুটিতেই কাজ করে।

  • আপনার ব্যাকএন্ড প্ল্যাটফর্ম একটি অনুমোদনের কোড এন্ডপয়েন্ট হোস্ট করে।

  • আপনার ব্যাকএন্ড প্ল্যাটফর্ম ব্যবহারকারীদের হয়ে Google API কল করে, এর জন্য ব্যবহারকারীদের উপস্থিত থাকার প্রয়োজন হয় না, এটি অফলাইন মোড নামেও পরিচিত।

  • আপনার ব্যাকএন্ড প্ল্যাটফর্ম রিফ্রেশ টোকেন ম্যানেজ ও স্টোর করে।

কিছু ক্ষেত্রে, আপনার কোডবেস দুটি ফ্লোকেই সাপোর্ট করতে পারে।

অনুমোদন ফ্লো বেছে নিন

মাইগ্রেশন শুরু করার আগে আপনাকে নির্ধারণ করতে হবে যে আপনার বর্তমান ফ্লো চালিয়ে যাওয়া নাকি অন্য কোনও ফ্লো গ্রহণ করা আপনার প্রয়োজন সবচেয়ে ভালোভাবে পূরণ করে।

দুটি ফ্লোয়ের মধ্যে মূল পার্থক্য ও ট্রেড-অফ বুঝতে অনুমোদন ফ্লো বেছে নেওয়া পর্যালোচনা করুন।

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

বাছাইকারী ব্যবহার করে অনুমোদনের ফ্লো বেছে নিন।

ইমপ্লিসিট ফ্লো

ব্যবহারকারী উপস্থিত থাকাকালীন ব্রাউজারে ব্যবহারের জন্য একটি অ্যাক্সেস টোকেন পান।

ইমপ্লিসিট ফ্লোয়ের উদাহরণ Identity Services-এ মাইগ্রেট করার আগে ও পরে ওয়েব অ্যাপ দেখায়।

অথরাইজেশন কোডের ফ্লো

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

অথরাইজেশন কোডের ফ্লো সংক্রান্ত উদাহরণ থেকে Identity Services-এ মাইগ্রেট করার আগে ও পরে ওয়েব অ্যাপ কেমন দেখায় তা জানা যায়।

এই নির্দেশিকা জুড়ে, আগে থেকে থাকা কার্যকারিতা যোগ করতে, সরাতে, আপডেট করতে অথবা পরিবর্তন করতে বোল্ডে তালিকাভুক্ত নির্দেশাবলী অনুসরণ করুন।

আপনার ইন-ব্রাউজার ওয়েব অ্যাপে পরিবর্তন

Google Identity Services জাভাস্ক্রিপ্ট লাইব্রেরিতে মাইগ্রেট করার সময়, আপনার ইন-ব্রাউজার ওয়েব অ্যাপে আপনি যেসব পরিবর্তন করবেন, এই বিভাগ সেগুলি পর্যালোচনা করে।

প্রভাবিত কোড শনাক্ত ও পরীক্ষা করা

ডিবাগ কুকি, প্রভাবিত কোড খুঁজে পেতে এবং অবচয়-পরবর্তী আচরণ পরীক্ষা করতে সাহায্য করতে পারে।

বড় বা জটিল অ্যাপে, gapi.auth2 মডিউল বন্ধ হয়ে যাওয়ার কারণে প্রভাবিত হওয়া সব কোড খুঁজে পাওয়া কঠিন হতে পারে। কনসোলে শীঘ্রই বন্ধ হয়ে যাবে এমন ফাংশনের বর্তমান ব্যবহার লগ করতে, G_AUTH2_MIGRATION কুকির ভ্যালু informational-এ সেট করুন। বিকল্প হিসেবে, সেশন স্টোরেজে লগ করার জন্য একটি কোলন এবং তারপরে একটি কী ভ্যালু যোগ করুন। সাইন-ইন করার পরে এবং ক্রেডেনশিয়াল পর্যালোচনা বা পরে বিশ্লেষণের জন্য ব্যাকএন্ডে সংগৃহীত লগ পাঠানোর পরে। যেমন, informational:showauth2use, showauth2use নামের সেশন স্টোরেজ কীতে অরিজিন ও URL সেভ করে।

gapi.auth2 মডিউল আর লোড না হলে অ্যাপের আচরণ যাচাই করতে, G_AUTH2_MIGRATION কুকির ভ্যালু enforced-এ সেট করুন। এটি এনফোর্সমেন্টের তারিখের আগে পোস্ট-ডেপ্রিকেশন আচরণ পরীক্ষা করার সুবিধা দেয়।

সম্ভাব্য G_AUTH2_MIGRATION কুকি ভ্যালু:

  • enforced gapi.auth2 মডিউল লোড করবেন না।
  • informational JS কনসোলে শীঘ্রই বন্ধ হয়ে যাবে এমন কার্যকারিতার ব্যবহার লগ করুন। এছাড়াও, ঐচ্ছিক কী নাম সেট করা হলে সেশন স্টোরেজে লগ করুন: informational:key-name.

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

লাইব্রেরি ও মডিউল

gapi.auth2 মডিউল সাইন-ইনের জন্য ব্যবহারকারীর যাচাইকরণ এবং অনুমোদনের জন্য ইমপ্লিসিট ফ্লো ম্যানেজ করে, এই বন্ধ হয়ে যাওয়া মডিউল এবং এর অবজেক্ট ও পদ্ধতি Google Identity সম্পর্কিত পরিষেবার লাইব্রেরি দিয়ে পরিবর্তন করুন।

আপনার ডকুমেন্টে অন্তর্ভুক্ত করার মাধ্যমে আপনার ওয়েব অ্যাপে Identity Services লাইব্রেরি যোগ করুন:

<script src="https://accounts.google.com/gsi/client" async defer></script>

gapi.load('auth2', function) ব্যবহার করে auth2 মডিউল লোড করার যেকোনও ইনস্ট্যান্স সরিয়ে দিন।

Google Identity Services লাইব্রেরি gapi.auth2 মডিউলের ব্যবহারকে প্রতিস্থাপন করে। আপনি নিরাপদে JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি থেকে gapi.client মডিউল ব্যবহার করা চালিয়ে যেতে পারেন এবং ডিসকভারি ডকুমেন্ট থেকে কল করা যায় এমন JS পদ্ধতি অটোমেটিক তৈরি করা, একাধিক API কল ব্যাচ করা এবং CORS ম্যানেজমেন্ট কার্যকারিতার সুবিধা নিতে পারেন।

কুকিজ

ব্যবহারকারীর অনুমোদনের জন্য কুকি ব্যবহার করার প্রয়োজন নেই।

ব্যবহারকারীর যাচাইকরণ কীভাবে কুকি ব্যবহার করে তার বিবরণের জন্য Google Sign-In থেকে মাইগ্রেট করা দেখুন এবং অন্যান্য Google প্রোডাক্ট ও পরিষেবার মাধ্যমে কুকি ব্যবহারের জন্য Google কীভাবে কুকি ব্যবহার করে দেখুন।

ক্রেডেনশিয়াল

Google Identity Services ব্যবহারকারীর যাচাইকরণ ও অনুমোদনকে দুটি আলাদা অপারেশনে ভাগ করে এবং ব্যবহারকারীর ক্রেডেনশিয়াল আলাদা হয়: ব্যবহারকারীকে শনাক্ত করার জন্য ব্যবহৃত আইডি টোকেন অনুমোদনের জন্য ব্যবহৃত অ্যাক্সেস টোকেন থেকে আলাদাভাবে ফেরত দেওয়া হয়।

এইসব পরিবর্তন দেখতে, ক্রেডেনশিয়ালের উদাহরণ দেখুন।

ইমপ্লিসিট ফ্লো

ব্যবহারকারীর প্রোফাইল হ্যান্ডলিং অনুমোদনের ফ্লো থেকে সরিয়ে দিয়ে ব্যবহারকারীর যাচাইকরণ ও অনুমোদন আলাদা করুন।

এই Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স সরিয়ে দিন:

পদ্ধতি

  • GoogleUser.getBasicProfile()
  • GoogleUser.getId()

অথরাইজেশন কোডের ফ্লো

Identity Services ব্রাউজারে থাকা ক্রেডেনশিয়ালকে আইডি টোকেন ও অ্যাক্সেস টোকেনে আলাদা করে। আপনার ব্যাকএন্ড প্ল্যাটফর্ম থেকে Google OAuth 2.0 এন্ডপয়েন্টে সরাসরি কল করার মাধ্যমে অথবা আপনার প্ল্যাটফর্মের সুরক্ষিত সার্ভারে চলা লাইব্রেরির মাধ্যমে পাওয়া ক্রেডেনশিয়ালের ক্ষেত্রে এই পরিবর্তন প্রযোজ্য নয়, যেমন Google APIs Node.js Client।

সেশন স্টেট

আগে, Google Sign-In আপনাকে এগুলি ব্যবহার করে ব্যবহারকারীর সাইন-ইন স্ট্যাটাস ম্যানেজ করতে সাহায্য করত:

আপনার ওয়েব অ্যাপে সাইন-ইন স্ট্যাটাস ও ব্যবহারকারীর সেশন ম্যানেজ করার দায়িত্ব আপনার।

এই Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স সরিয়ে দিন:

অবজেক্ট:

  • gapi.auth2.SignInOptions

পদ্ধতি:

  • GoogleAuth.attachClickHandler()
  • GoogleAuth.isSignedIn()
  • GoogleAuth.isSignedIn.get()
  • GoogleAuth.isSignedIn.listen()
  • GoogleAuth.signIn()
  • GoogleAuth.signOut()
  • GoogleAuth.currentUser.get()
  • GoogleAuth.currentUser.listen()
  • GoogleUser.isSignedIn()

ক্লায়েন্ট কনফিগারেশন

ইমপ্লিসিট বা অথরাইজেশন কোডের ফ্লোয়ের জন্য টোকেন ক্লায়েন্ট শুরু করতে আপনার ওয়েব অ্যাপ আপডেট করুন।

এই Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স সরিয়ে দিন:

অবজেক্ট:

  • gapi.auth2.ClientConfig
  • gapi.auth2.OfflineAccessOptions

পদ্ধতি:

  • gapi.auth2.getAuthInstance()
  • GoogleUser.grant()

ইমপ্লিসিট ফ্লো

টোকেন ক্লায়েন্ট ইনিশিয়ালাইজ করুন লিঙ্কে দেওয়া উদাহরণ অনুসরণ করে আপনার ওয়েব অ্যাপ কনফিগার করতে TokenClientConfig অবজেক্ট এবং initTokenClient() কল যোগ করুন।

Google Identity Services-এর মাধ্যমে Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স পরিবর্তন করুন:

অবজেক্ট:

  • TokenClientConfig থাকা gapi.auth2.AuthorizeConfig

পদ্ধতি:

  • google.accounts.oauth2.initTokenClient() থাকা gapi.auth2.init()

প্যারামিটার:

  • TokenClientConfig.login_hint-এর সাথে gapi.auth2.AuthorizeConfig.login_hint.
  • TokenClientConfig.hd-এর সাথে gapi.auth2.GoogleUser.getHostedDomain()।

অথরাইজেশন কোডের ফ্লো

Code Client শুরু করুন লিঙ্কে দেওয়া উদাহরণ অনুসরণ করে, আপনার ওয়েব অ্যাপ কনফিগার করতে, CodeClientConfig অবজেক্ট ও initCodeClient() কল যোগ করুন।

ইমপ্লিসিট থেকে অথরাইজেশন কোডের ফ্লোতে পরিবর্তন করার সময়:

Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স সরিয়ে দিন

অবজেক্ট:

  • gapi.auth2.AuthorizeConfig

পদ্ধতি:

  • gapi.auth2.init()

প্যারামিটার:

  • gapi.auth2.AuthorizeConfig.login_hint
  • gapi.auth2.GoogleUser.getHostedDomain()

টোকেন সংক্রান্ত অনুরোধ

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

ইমপ্লিসিট ফ্লো

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

পরিবর্তন করুন Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স: Google Identity Services-এর সাথে:

পদ্ধতি:

  • TokenClient.requestAccessToken() থাকা gapi.auth2.authorize()
  • TokenClient.requestAccessToken()-এর সাথে GoogleUser.reloadAuthResponse()

অ্যাক্সেস টোকেনের অনুরোধ করতে বা বর্তমান টোকেনের মেয়াদ শেষ হয়ে গেলে নতুন টোকেন পেতে, পপ-আপ UX ফ্লো শুরু করতে requestAccessToken()-এ কল করার জন্য একটি লিঙ্ক বা বোতাম যোগ করুন।

আপনার কোডবেস আপডেট করুন:

  • requestAccessToken()-এর সাথে OAuth 2.0 টোকেন ফ্লো ট্রিগার করুন।
  • requestAccessToken এবং OverridableTokenClientConfig ব্যবহার করে ইনক্রিমেন্টাল অনুমোদনের সুবিধা দিন যাতে অনেক স্কোপের জন্য একটি অনুরোধকে একাধিক ছোট অনুরোধে ভাগ করা যায়।
  • আগে থেকে থাকা টোকেনের মেয়াদ শেষ হয়ে গেলে বা সেটি তুলে নেওয়া হলে, নতুন টোকেনের জন্য অনুরোধ করুন।

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

অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, gapi.auth2 মডিউল অটোমেটিক আপনার ওয়েব অ্যাপের জন্য নতুন, বৈধ অ্যাক্সেস টোকেন পেয়ে যায়। ব্যবহারকারীর নিরাপত্তা আরও উন্নত করতে, এই অটোমেটিক টোকেন রিফ্রেশ করার প্রসেস Google Identity Services লাইব্রেরিতে কাজ করে না। মেয়াদ শেষ হয়ে যাওয়া অ্যাক্সেস টোকেন শনাক্ত করতে এবং নতুন টোকেনের অনুরোধ করতে আপনার ওয়েব অ্যাপ আপডেট করতে হবে। আরও জানতে টোকেন ম্যানেজ করা বিভাগ দেখুন।

অথরাইজেশন কোডের ফ্লো

Google থেকে অনুমোদনের কোড পাওয়ার অনুরোধ করতে requestCode()-এ কল করার জন্য একটি লিঙ্ক বা বোতাম যোগ করুন। উদাহরণ হিসেবে, OAuth 2.0 কোড ফ্লো ট্রিগার করুন দেখুন।

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

টোকেন ম্যানেজ করা

মেয়াদ শেষ হয়ে যাওয়া বা তুলে নেওয়া অ্যাক্সেস টোকেন ব্যবহার করা হলে, Google API কল ব্যর্থ হওয়ার ঘটনা শনাক্ত করতে এবং নতুন, বৈধ অ্যাক্সেস টোকেনের অনুরোধ করতে, সমস্যা ম্যানেজ করার সুবিধা যোগ করুন।

মেয়াদ শেষ হয়ে যাওয়া বা তুলে নেওয়া অ্যাক্সেস টোকেন ব্যবহার করা হলে, Google API-এর মাধ্যমে 401 Unauthorized HTTP স্ট্যাটাস কোড ও invalid_token সমস্যার মেসেজ দেখানো হয়। উদাহরণ হিসেবে, ভুল টোকেন রেসপন্স দেখুন।

মেয়াদ শেষ হয়ে যাওয়া টোকেন

অ্যাক্সেস টোকেন অল্প সময়ের জন্য কাজ করে এবং প্রায়শই মাত্র কয়েক মিনিটের জন্য বৈধ থাকে।

টোকেন প্রত্যাহার

যেকোনও সময়, Google অ্যাকাউন্টের মালিক আগে দেওয়া সম্মতি প্রত্যাহার করতে পারেন। এটি করলে আগে থেকে থাকা অ্যাক্সেস টোকেন ও রিফ্রেশ টোকেন বাতিল হয়ে যায়। revoke() ব্যবহার করে আপনার প্ল্যাটফর্ম থেকে অথবা Google অ্যাকাউন্ট-এর মাধ্যমে প্রত্যাহার করার প্রক্রিয়া ট্রিগার করা হতে পারে।

পরিবর্তন করুন Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স: Google Identity Services-এর সাথে:

পদ্ধতি:

  • google.accounts.oauth2.revoke() থাকা getAuthInstance().disconnect()
  • google.accounts.oauth2.revoke() থাকা GoogleUser.disconnect()

ব্যবহারকারী আপনার প্ল্যাটফর্মে তার অ্যাকাউন্ট মুছে দিলে অথবা আপনার অ্যাপের সাথে ডেটা শেয়ার করার সম্মতি প্রত্যাহার করতে চাইলে revoke কল করুন।

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

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

ব্যবহারকারীর সাইন-ইন

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

  • ব্যবহারকারীকে যতবার সাইন-ইন করতে হয় তার সংখ্যা কমায়, অ্যাক্সেস টোকেনের জন্য অনুরোধ করলে, ইতিমধ্যে কোনও অ্যাক্টিভ সেশন না থাকলে, Google অ্যাকাউন্ট সাইন-ইন প্রসেস শুরু করে।
  • CodeClientConfig বা TokenClientConfig অবজেক্টে login_hint প্যারামিটারের ভ্যালু হিসেবে JWT ID টোকেন ক্রেডেনশিয়াল email ফিল্ডের সরাসরি ব্যবহার। আপনার প্ল্যাটফর্ম যদি ব্যবহারকারীর অ্যাকাউন্ট ম্যানেজমেন্ট সিস্টেম বজায় না রাখে, তাহলে এটি বিশেষভাবে সহায়ক হয়।
  • আপনার প্ল্যাটফর্মে আগে থেকে থাকা স্থানীয় ব্যবহারকারীর অ্যাকাউন্টের সাথে Google অ্যাকাউন্ট খুঁজে নিয়ে তা যোগ করুন, এটি আপনার প্ল্যাটফর্মে ডুপ্লিকেট অ্যাকাউন্ট তৈরি হওয়ার সম্ভাবনা কম করতে সাহায্য করে।
  • নতুন, স্থানীয় অ্যাকাউন্ট তৈরি করা হলে, আপনার সাইন-আপ ডায়ালগ ও ফ্লো, ব্যবহারকারীর যাচাইকরণ ডায়ালগ ও ফ্লো থেকে স্পষ্টভাবে আলাদা করা যেতে পারে, যার ফলে প্রয়োজনীয় ধাপের সংখ্যা কমে যায় এবং ড্রপ-অফ রেট উন্নত হয়।

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

সম্মতি দেওয়ার পরে, ব্যবহারকারীর অনুমোদন করা বা বাতিল করা স্কোপের তালিকার সাথে অ্যাক্সেস টোকেন ফেরত দেওয়া হয়।

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

ইমপ্লিসিট ফ্লো

Google Identity Services-এর মাধ্যমে Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স পরিবর্তন করুন:

অবজেক্ট:

  • TokenClient.TokenResponse থাকা gapi.auth2.AuthorizeResponse
  • TokenClient.TokenResponse থাকা gapi.auth2.AuthResponse

পদ্ধতি:

  • google.accounts.oauth2.hasGrantedAllScopes()-এর সাথে GoogleUser.hasGrantedScopes()
  • google.accounts.oauth2.hasGrantedAllScopes()-এর GoogleUser.getGrantedScopes()

Google Sign-In জাভাস্ক্রিপ্ট ক্লায়েন্ট রেফারেন্স সরিয়ে দিন:

পদ্ধতি:

  • GoogleUser.getAuthResponse()

এই গ্র্যানুলার অনুমতি সংক্রান্ত উদাহরণ অনুসরণ করে hasGrantedAllScopes() এবং hasGrantedAnyScope()-এর মাধ্যমে আপনার ওয়েব অ্যাপ আপডেট করুন।

অথরাইজেশন কোডের ফ্লো

অথরাইজেশন কোড ম্যানেজ করা লিঙ্কে দেওয়া নির্দেশাবলী অনুসরণ করে আপনার ব্যাকএন্ড প্ল্যাটফর্মে অথরাইজেশন কোড এন্ডপয়েন্ট আপডেট করুন বা যোগ করুন।

অনুরোধ যাচাই করতে এবং অ্যাক্সেস টোকেন ও রিফ্রেশ টোকেন পেতে, কোড মডেল ব্যবহার করুন গাইড-এ বর্ণিত ধাপগুলি অনুসরণ করতে আপনার প্ল্যাটফর্ম আপডেট করুন।

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

ইমপ্লিসিট ফ্লোর উদাহরণ

পুরনো পদ্ধতি

GAPI ক্লায়েন্ট লাইব্রেরি

ব্যবহারকারীর সম্মতি নেওয়ার জন্য পপ-আপ ডায়ালগ ব্যবহার করে ব্রাউজারে চলা JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি-এর উদাহরণ।

gapi.auth2 মডিউলটি অটোমেটিক লোড হয় এবং gapi.client.init()-এর মাধ্যমে ব্যবহার করা হয়, তাই এটি লুকানো থাকে।

<!DOCTYPE html>
  <html>
    <head>
      <script src="https://apis.google.com/js/api.js"></script>
      <script>
        function start() {
          gapi.client.init({
            'apiKey': 'YOUR_API_KEY',
            'clientId': 'YOUR_CLIENT_ID',
            'scope': 'https://www.googleapis.com/auth/cloud-translation',
            'discoveryDocs': ['https://www.googleapis.com/discovery/v1/apis/translate/v2/rest'],
          }).then(function() {
            // Execute an API request which is returned as a Promise.
            // The method name language.translations.list comes from the API discovery.
            return gapi.client.language.translations.list({
              q: 'hello world',
              source: 'en',
              target: 'de',
            });
          }).then(function(response) {
            console.log(response.result.data.translations[0].translatedText);
          }, function(reason) {
            console.log('Error: ' + reason.result.error.message);
          });
        };

        // Load the JavaScript client library and invoke start afterwards.
        gapi.load('client', start);
      </script>
    </head>
    <body>
      <div id="results"></div>
    </body>
  </html>

JS ক্লায়েন্ট লাইব্রেরি

ব্যবহারকারীর সম্মতির জন্য পপ-আপ ডায়ালগ ব্যবহার করে ব্রাউজারে চলা ক্লায়েন্ট-সাইড ওয়েব অ্যাপ্লিকেশনের জন্য OAuth 2.0।

gapi.auth2 মডিউল ম্যানুয়ালি লোড করা হয়েছে।

<!DOCTYPE html>
<html><head></head><body>
<script>
  var GoogleAuth;
  var SCOPE = 'https://www.googleapis.com/auth/drive.metadata.readonly';
  function handleClientLoad() {
    // Load the API's client and auth2 modules.
    // Call the initClient function after the modules load.
    gapi.load('client:auth2', initClient);
  }

  function initClient() {
    // In practice, your app can retrieve one or more discovery documents.
    var discoveryUrl = 'https://www.googleapis.com/discovery/v1/apis/drive/v3/rest';

    // Initialize the gapi.client object, which app uses to make API requests.
    // Get API key and client ID from Google Cloud console.
    // 'scope' field specifies space-delimited list of access scopes.
    gapi.client.init({
        'apiKey': 'YOUR_API_KEY',
        'clientId': 'YOUR_CLIENT_ID',
        'discoveryDocs': [discoveryUrl],
        'scope': SCOPE
    }).then(function () {
      GoogleAuth = gapi.auth2.getAuthInstance();

      // Listen for sign-in state changes.
      GoogleAuth.isSignedIn.listen(updateSigninStatus);

      // Handle initial sign-in state. (Determine if user is already signed in.)
      var user = GoogleAuth.currentUser.get();
      setSigninStatus();

      // Call handleAuthClick function when user clicks on
      //      "Sign In/Authorize" button.
      $('#sign-in-or-out-button').click(function() {
        handleAuthClick();
      });
      $('#revoke-access-button').click(function() {
        revokeAccess();
      });
    });
  }

  function handleAuthClick() {
    if (GoogleAuth.isSignedIn.get()) {
      // User is authorized and has clicked "Sign out" button.
      GoogleAuth.signOut();
    } else {
      // User is not signed in. Start Google auth flow.
      GoogleAuth.signIn();
    }
  }

  function revokeAccess() {
    GoogleAuth.disconnect();
  }

  function setSigninStatus() {
    var user = GoogleAuth.currentUser.get();
    var isAuthorized = user.hasGrantedScopes(SCOPE);
    if (isAuthorized) {
      $('#sign-in-or-out-button').html('Sign out');
      $('#revoke-access-button').css('display', 'inline-block');
      $('#auth-status').html('You are currently signed in and have granted ' +
          'access to this app.');
    } else {
      $('#sign-in-or-out-button').html('Sign In/Authorize');
      $('#revoke-access-button').css('display', 'none');
      $('#auth-status').html('You have not authorized this app or you are ' +
          'signed out.');
    }
  }

  function updateSigninStatus() {
    setSigninStatus();
  }
</script>

<button id="sign-in-or-out-button"
        style="margin-left: 25px">Sign In/Authorize</button>
<button id="revoke-access-button"
        style="display: none; margin-left: 25px">Revoke access</button>

<div id="auth-status" style="display: inline; padding-left: 25px"></div><hr>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script async defer src="https://apis.google.com/js/api.js"
        onload="this.onload=function(){};handleClientLoad()"
        onreadystatechange="if (this.readyState === 'complete') this.onload()">
</script>
</body></html>

OAuth 2.0 এন্ডপয়েন্ট

ব্যবহারকারীর সম্মতি পাওয়ার জন্য Google অনুমোদন সার্ভারে রিডাইরেক্ট করার মাধ্যমে ব্রাউজারে চলা ক্লায়েন্ট-সাইড ওয়েব অ্যাপ্লিকেশনের জন্য OAuth 2.0।

এই উদাহরণে ব্যবহারকারীর ব্রাউজার থেকে Google-এর OAuth 2.0 এন্ডপয়েন্টে সরাসরি কল করার বিষয়টি দেখানো হয়েছে এবং এতে gapi.auth2 মডিউল বা JavaScript লাইব্রেরি ব্যবহার করা হয়নি।

<!DOCTYPE html>
<html><head></head><body>
<script>
  var YOUR_CLIENT_ID = 'REPLACE_THIS_VALUE';
  var YOUR_REDIRECT_URI = 'REPLACE_THIS_VALUE';
  var fragmentString = location.hash.substring(1);

  // Parse query string to see if page request is coming from the Google authorization server.
  var params = {};
  var regex = /([^&=]+)=([^&]*)/g, m;
  while (m = regex.exec(fragmentString)) {
    params[decodeURIComponent(m[1])] = decodeURIComponent(m[2]);
  }
  if (Object.keys(params).length > 0) {
    localStorage.setItem('oauth2-test-params', JSON.stringify(params) );
    if (params['state'] && params['state'] == 'try_sample_request') {
      trySampleRequest();
    }
  }

  // If there's an access token, try an API request.
  // Otherwise, start OAuth 2.0 flow.
  function trySampleRequest() {
    var params = JSON.parse(localStorage.getItem('oauth2-test-params'));
    if (params && params['access_token']) {
      var xhr = new XMLHttpRequest();
      xhr.open('GET',
          'https://www.googleapis.com/drive/v3/about?fields=user&' +
          'access_token=' + params['access_token']);
      xhr.onreadystatechange = function (e) {
        if (xhr.readyState === 4 && xhr.status === 200) {
          console.log(xhr.response);
        } else if (xhr.readyState === 4 && xhr.status === 401) {
          // Token invalid, so prompt for user permission.
          oauth2SignIn();
        }
      };
      xhr.send(null);
    } else {
      oauth2SignIn();
    }
  }

  /*
   * Create form to request access token from the Google authorization server.
   */
function oauth2SignIn() {
  // Google's OAuth 2.0 endpoint for requesting an access token
  var oauth2Endpoint = 'https://accounts.google.com/o/oauth2/v2/auth';

    // Create element to open OAuth 2.0 endpoint in new window.
    var form = document.createElement('form');
    form.setAttribute('method', 'GET'); // Send as a GET request.
    form.setAttribute('action', oauth2Endpoint);

    // Parameters to pass to OAuth 2.0 endpoint.
    var params = {'client_id': YOUR_CLIENT_ID,
                  'redirect_uri': YOUR_REDIRECT_URI,
                  'scope': 'https://www.googleapis.com/auth/drive.metadata.readonly',
                  'state': 'try_sample_request',
                  'include_granted_scopes': 'true',
                  'response_type': 'token'};

    // Add form parameters as hidden input values.
    for (var p in params) {
      var input = document.createElement('input');
      input.setAttribute('type', 'hidden');
      input.setAttribute('name', p);
      input.setAttribute('value', params[p]);
      form.appendChild(input);
    }

    // Add form to page and submit it to open the OAuth 2.0 endpoint.
    document.body.appendChild(form);
    form.submit();
  }
</script>

<button onclick="trySampleRequest();">Try sample request</button>
</body></html>

নতুন উপায়

শুধুমাত্র GIS

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

<!DOCTYPE html>
<html>
  <head>
    <script src="https://accounts.google.com/gsi/client" onload="initClient()" async defer></script>
  </head>
  <body>
    <script>
      var client;
      var access_token;

      function initClient() {
        client = google.accounts.oauth2.initTokenClient({
          client_id: 'YOUR_CLIENT_ID',
          scope: 'https://www.googleapis.com/auth/calendar.readonly \
                  https://www.googleapis.com/auth/contacts.readonly',
          callback: (tokenResponse) => {
            access_token = tokenResponse.access_token;
          },
        });
      }
      function getToken() {
        client.requestAccessToken();
      }
      function revokeToken() {
        google.accounts.oauth2.revoke(access_token, () => {console.log('access token revoked')});
      }
      function loadCalendar() {
        var xhr = new XMLHttpRequest();
        xhr.open('GET', 'https://www.googleapis.com/calendar/v3/calendars/primary/events');
        xhr.setRequestHeader('Authorization', 'Bearer ' + access_token);
        xhr.send();
      }
    </script>
    <h1>Google Identity Services Authorization Token model</h1>
    <button onclick="getToken();">Get access token</button><br><br>
    <button onclick="loadCalendar();">Load Calendar</button><br><br>
    <button onclick="revokeToken();">Revoke token</button>
  </body>
</html>

GAPI async/await

এই উদাহরণে দেখানো হয়েছে যে কীভাবে টোকেন মডেল ব্যবহার করে Google Identity Service লাইব্রেরি যোগ করতে হয়, gapi.auth2 মডিউল সরাতে হয় এবং JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে API কল করতে হয়।

লাইব্রেরি লোড করার ক্রম এনফোর্স করতে এবং অথরাইজেশন সংক্রান্ত সমস্যা ধরতে ও আবার চেষ্টা করতে প্রমিস, অ্যাসিঙ্ক ও অ্যাওয়েট ব্যবহার করা হয়। শুধুমাত্র সঠিক অ্যাক্সেস টোকেন উপলভ্য হওয়ার পরেই API কল করা হয়।

পৃষ্ঠাটি প্রথমবার লোড করার সময় অ্যাক্সেস টোকেন না থাকলে বা পরে অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, ব্যবহারকারীদের 'ক্যালেন্ডার দেখুন' বোতামে প্রেস করতে হবে।

<!DOCTYPE html>
<html>
<head>
    <title>GAPI and GIS Example</title>
    <script async defer src="https://apis.google.com/js/api.js" onload="gapiLoad()"></script>
    <script async defer src="https://accounts.google.com/gsi/client" onload="gisLoad()"></script>
</head>
<body>
    <h1>GAPI Client with GIS Authorization</h1>
    <button id="authorizeBtn" style="visibility:hidden;">Authorize and Load Events</button>
    <button id="revokeBtn" style="visibility:hidden;">Revoke Access</button>
    <div id="content"></div>

    <script>
        const YOUR_CLIENT_ID = "YOUR_CLIENT_ID";
        const YOUR_API_KEY = 'YOUR_API_KEY';
        const CALENDAR_SCOPE = 'https://www.googleapis.com/auth/calendar.readonly';

        let tokenClient;
        let libsLoaded = 0;

        function gapiLoad() {
            gapi.load('client', initGapiClient);
        }

        async function initGapiClient() {
            try {
                await gapi.client.init({ apiKey: YOUR_API_KEY });
                await gapi.client.load('https://www.googleapis.com/discovery/v1/apis/calendar/v3/rest');
                console.log('GAPI client initialized.');
                checkAllLoaded();
            } catch (err) {
                handleError('GAPI initialization failed:', err);
            }
        }

        function gisLoad() {
            try {
                tokenClient = google.accounts.oauth2.initTokenClient({
                    client_id: YOUR_CLIENT_ID,
                    scope: CALENDAR_SCOPE,
                    callback: '', // Will be set dynamically
                    error_callback: handleGisError,
                });
                console.log('GIS TokenClient initialized.');
                checkAllLoaded();
            } catch (err) {
                handleError('GIS initialization failed:', err);
            }
        }

        function checkAllLoaded() {
            libsLoaded++;
            if (libsLoaded === 2) {
                document.getElementById('authorizeBtn').style.visibility = 'visible';
                document.getElementById('revokeBtn').style.visibility = 'visible';
                document.getElementById('authorizeBtn').onclick = makeApiCall;
                document.getElementById('revokeBtn').onclick = revokeAccess;
                console.log('Ready to authorize.');
            }
        }

        function handleGisError(err) {
            console.error('GIS Error:', err);
            let message = 'An error occurred during authorization.';
            if (err && err.type === 'popup_failed_to_open') {
                message = 'Failed to open popup. Please disable popup blockers.';
            } else if (err && err.type === 'popup_closed') {
                message = 'Authorization popup was closed.';
            }
            document.getElementById('content').textContent = message;
        }

        function handleError(message, error) {
            console.error(message, error);
            document.getElementById('content').textContent = `${message} ${error.message || JSON.stringify(error)}`;
        }

        async function makeApiCall() {
            document.getElementById('content').textContent = 'Processing...';
            try {
                let token = gapi.client.getToken();
                if (!token || !token.access_token) {
                    console.log('No token, fetching one...');
                    await getToken();
                }

                console.log('Calling Calendar API...');
                const response = await gapi.client.calendar.events.list({ 'calendarId': 'primary' });
                displayEvents(response.result);
            } catch (err) {
                console.error('API call failed:', err);
                const errorInfo = err.result && err.result.error;
                if (errorInfo && (errorInfo.code === 401 || (errorInfo.code === 403 && errorInfo.status === "PERMISSION_DENIED"))) {
                    console.log('Auth error on API call, refreshing token...');
                    try {
                        await getToken({ prompt: 'consent' }); // Force refresh
                        const retryResponse = await gapi.client.calendar.events.list({ 'calendarId': 'primary' });
                        displayEvents(retryResponse.result);
                    } catch (refreshErr) {
                        handleError('Failed to refresh token or retry API call:', refreshErr);
                    }
                } else {
                    handleError('Error loading events:', err.result ? err.result.error : err);
                }
            }
        }

        async function getToken(options = { prompt: '' }) {
            return new Promise((resolve, reject) => {
                if (!tokenClient) return reject(new Error("GIS TokenClient not initialized."));
                tokenClient.callback = (tokenResponse) => {
                    if (tokenResponse.error) {
                        reject(new Error(`Token Error: ${tokenResponse.error} - ${tokenResponse.error_description}`));
                    } else {
                        console.log('Token acquired.');
                        resolve(tokenResponse);
                    }
                };
                tokenClient.requestAccessToken(options);
            });
        }

        function displayEvents(result) {
            const events = result.items;
            if (events && events.length > 0) {
                let eventList = '<h3>Upcoming Events:</h3><ul>' + events.map(event =>
                    `<li>${event.summary} (${event.start.dateTime || event.start.date})</li>`
                ).join('') + '</ul>';
                document.getElementById('content').innerHTML = eventList;
            } else {
                document.getElementById('content').textContent = 'No upcoming events found.';
            }
        }

        function revokeAccess() {
            const token = gapi.client.getToken();
            if (token && token.access_token) {
                google.accounts.oauth2.revoke(token.access_token, () => {
                    console.log('Access revoked.');
                    document.getElementById('content').textContent = 'Access has been revoked.';
                    gapi.client.setToken(null);
                });
            } else {
                document.getElementById('content').textContent = 'No token to revoke.';
            }
        }
    </script>
</body>
</html>

GAPI কলব্যাক

এই উদাহরণে দেখানো হয়েছে যে কীভাবে টোকেন মডেল ব্যবহার করে Google Identity Service লাইব্রেরি যোগ করতে হয়, gapi.auth2 মডিউল সরাতে হয় এবং JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে API কল করতে হয়।

লাইব্রেরি লোড করার ক্রম এনফোর্স করতে ভেরিয়েবল ব্যবহার করা হয়। সঠিক অ্যাক্সেস টোকেন ফেরত পাওয়ার পরে কলব্যাক থেকে GAPI কল করা হয়।

পৃষ্ঠাটি প্রথমবার লোড হওয়ার সময় এবং ব্যবহারকারী তার ক্যালেন্ডার তথ্য রিফ্রেশ করতে চাইলে, তাকে 'ক্যালেন্ডার দেখুন' বোতামটি প্রেস করতে হবে।

<!DOCTYPE html>
<html>
<head>
  <script async defer src="https://apis.google.com/js/api.js" onload="gapiLoad()"></script>
  <script async defer src="https://accounts.google.com/gsi/client" onload="gisInit()"></script>
</head>
<body>
  <h1>GAPI with GIS callbacks</h1>
  <button id="showEventsBtn" onclick="showEvents();">Show Calendar</button><br><br>
  <button id="revokeBtn" onclick="revokeToken();">Revoke access token</button>
  <script>
    let tokenClient;
    let gapiInited;
    let gisInited;

    document.getElementById("showEventsBtn").style.visibility="hidden";
    document.getElementById("revokeBtn").style.visibility="hidden";

    function checkBeforeStart() {
       if (gapiInited && gisInited){
          // Start only when both gapi and gis are initialized.
          document.getElementById("showEventsBtn").style.visibility="visible";
          document.getElementById("revokeBtn").style.visibility="visible";
       }
    }

    function gapiInit() {
      gapi.client.init({
        // NOTE: OAuth2 'scope' and 'client_id' parameters have moved to initTokenClient().
      })
      .then(function() {  // Load the Calendar API discovery document.
        gapi.client.load('https://www.googleapis.com/discovery/v1/apis/calendar/v3/rest');
        gapiInited = true;
        checkBeforeStart();
      });
    }

    function gapiLoad() {
        gapi.load('client', gapiInit)
    }

    function gisInit() {
     tokenClient = google.accounts.oauth2.initTokenClient({
                client_id: 'YOUR_CLIENT_ID',
                scope: 'https://www.googleapis.com/auth/calendar.readonly',
                callback: '',  // defined at request time
            });
      gisInited = true;
      checkBeforeStart();
    }

    function showEvents() {

      tokenClient.callback = (resp) => {
        if (resp.error !== undefined) {
          throw(resp);
        }
        // GIS has automatically updated gapi.client with the newly issued access token.
        console.log('gapi.client access token: ' + JSON.stringify(gapi.client.getToken()));

        gapi.client.calendar.events.list({ 'calendarId': 'primary' })
        .then(calendarAPIResponse => console.log(JSON.stringify(calendarAPIResponse)))
        .catch(err => console.log(err));

        document.getElementById("showEventsBtn").innerText = "Refresh Calendar";
      }

      // Conditionally ask users to select the Google Account they'd like to use,
      // and explicitly obtain their consent to fetch their Calendar.
      // NOTE: To request an access token a user gesture is necessary.
      if (gapi.client.getToken() === null) {
        // Prompt the user to select a Google Account and asked for consent to share their data
        // when establishing a new session.
        tokenClient.requestAccessToken({prompt: 'consent'});
      } else {
        // Skip display of account chooser and consent dialog for an existing session.
        tokenClient.requestAccessToken({prompt: ''});
      }
    }

    function revokeToken() {
      let cred = gapi.client.getToken();
      if (cred !== null) {
        google.accounts.oauth2.revoke(cred.access_token, () => {console.log('Revoked: ' + cred.access_token)});
        gapi.client.setToken('');
        document.getElementById("showEventsBtn").innerText = "Show Calendar";
      }
    }
  </script>
</body>
</html>

অথরাইজেশন কোডের ফ্লোয়ের উদাহরণ

Google Identity Service লাইব্রেরি পপ-আপ UX, আপনার ব্যাকএন্ড টোকেন এন্ডপয়েন্টে সরাসরি একটি অনুমোদন কোড ফেরত দিতে URL রিডাইরেক্ট ব্যবহার করতে পারে অথবা ব্যবহারকারীর ব্রাউজারে রান করা জাভাস্ক্রিপ্ট কলব্যাক হ্যান্ডলার ব্যবহার করতে পারে যা আপনার প্ল্যাটফর্মে রেসপন্স প্রক্সি করে। যেকোনও ক্ষেত্রেই, আপনার ব্যাকএন্ড প্ল্যাটফর্ম, সঠিক রিফ্রেশ ও অ্যাক্সেস টোকেন পেতে OAuth 2.0 ফ্লো সম্পূর্ণ করবে।

পুরনো পদ্ধতি

সার্ভার-সাইড ওয়েব অ্যাপ

ব্যবহারকারীর সম্মতি পাওয়ার জন্য Google-এ রিডাইরেক্ট করার মাধ্যমে ব্যাকএন্ড প্ল্যাটফর্মে চলা সার্ভার-সাইড অ্যাপের জন্য Google Sign-In।

<!DOCTYPE html>
<html>
  <head>
    <script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
    <script src="https://apis.google.com/js/client:platform.js?onload=start" async defer></script>
    <script>
      function start() {
        gapi.load('auth2', function() {
          auth2 = gapi.auth2.init({
            client_id: 'YOUR_CLIENT_ID',
            api_key: 'YOUR_API_KEY',
            discovery_docs: ['https://www.googleapis.com/discovery/v1/apis/translate/v2/rest'],
            // Scopes to request in addition to 'profile' and 'email'
            scope: 'https://www.googleapis.com/auth/cloud-translation',
          });
        });
      }
      function signInCallback(authResult) {
        if (authResult['code']) {
          console.log("sending AJAX request");
          // Send authorization code obtained from Google to backend platform
          $.ajax({
            type: 'POST',
            url: 'YOUR_AUTHORIZATION_CODE_ENDPOINT_URL',
            // Always include an X-Requested-With header to protect against CSRF attacks.
            headers: {
              'X-Requested-With': 'XMLHttpRequest'
            },
            contentType: 'application/octet-stream; charset=utf-8',
            success: function(result) {
              console.log(result);
            },
            processData: false,
            data: authResult['code']
          });
        } else {
          console.log('error: failed to obtain authorization code')
        }
      }
    </script>
  </head>
  <body>
    <button id="signinButton">Sign In With Google</button>
    <script>
      $('#signinButton').click(function() {
        // Obtain an authorization code from Google
        auth2.grantOfflineAccess().then(signInCallback);
      });
    </script>
  </body>
</html>

রিডাইরেক্ট ব্যবহার করে HTTP/REST

ব্যবহারকারীর ব্রাউজার থেকে আপনার ব্যাকএন্ড প্ল্যাটফর্মে অনুমোদনের কোড পাঠাতে ওয়েব সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার করা। ব্যবহারকারীর ব্রাউজারকে Google-এর অনুমোদন সার্ভারে রিডাইরেক্ট করার মাধ্যমে ব্যবহারকারীর সম্মতি ম্যানেজ করা হয়।

/*
 * Create form to request access token from the Google authorization server.
 */
function oauthSignIn() {
  // Google's OAuth 2.0 endpoint for requesting an access token
  var oauth2Endpoint = 'https://accounts.google.com/o/oauth2/v2/auth';
  // Create &lt;form> element to submit parameters to OAuth 2.0 endpoint.
  var form = document.createElement('form');
  form.setAttribute('method', 'GET'); // Send as a GET request.
  form.setAttribute('action', oauth2Endpoint);
  // Parameters to pass to OAuth 2.0 endpoint.
  var params = {'client\_id': 'YOUR_CLIENT_ID',
                'redirect\_uri': 'YOUR_AUTHORIZATION_CODE_ENDPOINT_URL',
                'response\_type': 'token',
                'scope': 'https://www.googleapis.com/auth/drive.metadata.readonly',
                'include\_granted\_scopes': 'true',
                'state': 'pass-through value'};
  // Add form parameters as hidden input values.
  for (var p in params) {
    var input = document.createElement('input');
    input.setAttribute('type', 'hidden');
    input.setAttribute('name', p);
    input.setAttribute('value', params[p]);
    form.appendChild(input);
  }

  // Add form to page and submit it to open the OAuth 2.0 endpoint.
  document.body.appendChild(form);
  form.submit();
}

নতুন উপায়

GIS পপ-আপ UX

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

<!DOCTYPE html>
<html>
  <head>
    <script src="https://accounts.google.com/gsi/client" onload="initClient()" async defer></script>
  </head>
  <body>
    <script>
      var client;
      function initClient() {
        client = google.accounts.oauth2.initCodeClient({
          client_id: 'YOUR_CLIENT_ID',
          scope: 'https://www.googleapis.com/auth/calendar.readonly',
          ux_mode: 'popup',
          callback: (response) => {
            var code_receiver_uri = 'YOUR_AUTHORIZATION_CODE_ENDPOINT_URI',
            // Send auth code to your backend platform
            const xhr = new XMLHttpRequest();
            xhr.open('POST', code_receiver_uri, true);
            xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
            xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
            xhr.onload = function() {
              console.log('Signed in as: ' + xhr.responseText);
            };
            xhr.send('code=' + response.code);
            // After receipt, the code is exchanged for an access token and
            // refresh token, and the platform then updates this web app
            // running in user's browser with the requested calendar info.
          },
        });
      }
      function getAuthCode() {
        // Request authorization code and obtain user consent
        client.requestCode();
      }
    </script>
    <button onclick="getAuthCode();">Load Your Calendar</button>
  </body>
</html>

GIS রিডাইরেক্ট UX

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

<!DOCTYPE html>
<html>
  <head>
    <script src="https://accounts.google.com/gsi/client" onload="initClient()" async defer></script>
  </head>
  <body>
    <script>
      var client;
      function initClient() {
        client = google.accounts.oauth2.initCodeClient({
          client_id: 'YOUR_CLIENT_ID',
          scope: 'https://www.googleapis.com/auth/calendar.readonly \
                  https://www.googleapis.com/auth/photoslibrary.readonly',
          ux_mode: 'redirect',
          redirect_uri: 'YOUR_AUTHORIZATION_CODE_ENDPOINT_URI'
        });
      }
      // Request an access token
      function getAuthCode() {
        // Request authorization code and obtain user consent
        client.requestCode();
      }
    </script>
    <button onclick="getAuthCode();">Load Your Calendar</button>
  </body>
</html>

জাভাস্ক্রিপ্ট লাইব্রেরি

Google Identity Services হল একটি জাভাস্ক্রিপ্ট লাইব্রেরি যা ব্যবহারকারীর যাচাইকরণ এবং অনুমোদনের জন্য ব্যবহৃত হয়। এটি একাধিক বিভিন্ন লাইব্রেরি এবং মডিউলে পাওয়া ফিচার এবং ফাংশনালিটি একত্রিত করে এবং প্রতিস্থাপন করে:

আইডেন্টিটি সার্ভিসে মাইগ্রেট করার সময় যেসব অ্যাকশন নিতে হবে:

আগে থেকে থাকা JS লাইব্রেরি নতুন JS লাইব্রেরি নোট
apis.google.com/js/api.js accounts.google.com/gsi/client নতুন লাইব্রেরি যোগ করুন এবং ইমপ্লিসিট ফ্লো অনুসরণ করুন।
apis.google.com/js/client.js accounts.google.com/gsi/client নতুন লাইব্রেরি যোগ করুন এবং অথরাইজেশন কোডের ফ্লো অনুসরণ করুন।

লাইব্রেরি দ্রুত রেফারেন্স

পুরনো Google সাইন-ইন জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরি এবং নতুন Google Identity Services লাইব্রেরির মধ্যে অবজেক্ট ও পদ্ধতির তুলনা এবং মাইগ্রেশনের সময় অতিরিক্ত তথ্য ও অ্যাকশন সহ নোট।

পুরনো নতুন নোট
GoogleAuth অবজেক্ট এবং সংশ্লিষ্ট পদ্ধতি:
GoogleAuth.attachClickHandler() সরান
GoogleAuth.currentUser.get() সরান
GoogleAuth.currentUser.listen() সরান
GoogleAuth.disconnect() google.accounts.oauth2.revoke পুরনোটির জায়গায় নতুনটি ব্যবহার করুন। https://myaccount.google.com/permissions থেকেও প্রত্যাহার করা হতে পারে
GoogleAuth.grantOfflineAccess() সরান, অথরাইজেশন কোডের ফ্লো অনুসরণ করুন।
GoogleAuth.isSignedIn.get() সরান
GoogleAuth.isSignedIn.listen() সরান
GoogleAuth.signIn() সরান
GoogleAuth.signOut() সরান
GoogleAuth.then() সরান
GoogleUser অবজেক্ট এবং সংশ্লিষ্ট পদ্ধতি:
GoogleUser.disconnect() google.accounts.id.revoke পুরনোটির জায়গায় নতুনটি ব্যবহার করুন। https://myaccount.google.com/permissions থেকেও প্রত্যাহার করা হতে পারে
GoogleUser.getAuthResponse() requestCode() বা requestAccessToken() পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
GoogleUser.getBasicProfile() সরান। পরিবর্তে আইডি টোকেন ব্যবহার করুন; Google Sign-In থেকে মাইগ্রেট করা দেখুন।
GoogleUser.getGrantedScopes() hasGrantedAnyScope() পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
GoogleUser.getHostedDomain() সরান
GoogleUser.getId() সরান
GoogleUser.grantOfflineAccess() সরান, অথরাইজেশন কোডের ফ্লো অনুসরণ করুন।
GoogleUser.grant() সরান
GoogleUser.hasGrantedScopes() hasGrantedAnyScope() পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
GoogleUser.isSignedIn() সরান
GoogleUser.reloadAuthResponse() requestAccessToken() মেয়াদ শেষ হয়ে যাওয়া বা তুলে নেওয়া অ্যাক্সেস টোকেন পরিবর্তন করতে, পুরনোটি সরিয়ে নতুনটি কল করুন।
gapi.auth2 অবজেক্ট এবং সংশ্লিষ্ট পদ্ধতি:
gapi.auth2.AuthorizeConfig অবজেক্ট TokenClientConfig বা CodeClientConfig পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
gapi.auth2.AuthorizeResponse অবজেক্ট সরান
gapi.auth2.AuthResponse অবজেক্ট সরান
gapi.auth2.authorize() requestCode() বা requestAccessToken() পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
gapi.auth2.ClientConfig() TokenClientConfig বা CodeClientConfig পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
gapi.auth2.getAuthInstance() সরান
gapi.auth2.init() initTokenClient() বা initCodeClient() পুরনোটির জায়গায় নতুনটি ব্যবহার করুন
gapi.auth2.OfflineAccessOptions অবজেক্ট সরান
gapi.auth2.SignInOptions অবজেক্ট সরান
gapi.signin2 অবজেক্ট এবং সংশ্লিষ্ট পদ্ধতি:
gapi.signin2.render() সরান। g_id_signin এলিমেন্টের HTML DOM লোডিং বা google.accounts.id.renderButton-এ JS কল, Google অ্যাকাউন্টে ব্যবহারকারীর সাইন-ইন ট্রিগার করে।

ক্রেডেনশিয়ালের উদাহরণ

আগে থেকে থাকা ক্রেডেনশিয়াল

Google Sign-In প্ল্যাটফর্ম লাইব্রেরি, JavaScript-এর জন্য Google API ক্লায়েন্ট লাইব্রেরি অথবা Google OAuth 2.0 এন্ডপয়েন্টে সরাসরি কল করলে, একই উত্তরে OAuth 2.0 অ্যাক্সেস টোকেন এবং OpenID Connect ID টোকেন, দুটিই পাওয়া যায়।

access_token এবং id_token, দুটিই আছে এমন উত্তরের উদাহরণ:

  {
    "token_type": "Bearer",
    "access_token": "ya29.A0ARrdaM-SmArZaCIh68qXsZSzyeU-8mxhQERHrP2EXtxpUuZ-3oW8IW7a6D2J6lRnZrRj8S6-ZcIl5XVEqnqxq5fuMeDDH_6MZgQ5dgP7moY-yTiKR5kdPm-LkuPM-mOtUsylWPd1wpRmvw_AGOZ1UUCa6UD5Hg",
    "scope": "https://www.googleapis.com/auth/calendar.readonly",
    "login_hint": "AJDLj6I2d1RH77cgpe__DdEree1zxHjZJr4Q7yOisoumTZUmo5W2ZmVFHyAomUYzLkrluG-hqt4RnNxrPhArd5y6p8kzO0t8xIfMAe6yhztt6v2E-_Bb4Ec3GLFKikHSXNh5bI-gPrsI",
    "expires_in": 3599,
    "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjkzNDFhYmM0MDkyYjZmYzAzOGU0MDNjOTEwMjJkZDNlNDQ1MzliNTYiLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJhY2NvdW50cy5nb29nbGUuY29tIiwiYXpwIjoiNTM4MzQ0NjUzMjU1LTc1OGM1aDVpc2M0NXZnazI3ZDhoOGRlYWJvdnBnNnRvLmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwiYXVkIjoiNTM4MzQ0NjUzMjU1LTc1OGM1aDVpc2M0NXZnazI3ZDhoOGRlYWJvdnBnNnRvLmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwic3ViIjoiMTE3NzI2NDMxNjUxOTQzNjk4NjAwIiwiaGQiOiJnb29nbGUuY29tIiwiZW1haWwiOiJkYWJyaWFuQGdvb2dsZS5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwiYXRfaGFzaCI6IkJBSW55TjN2MS1ZejNLQnJUMVo0ckEiLCJuYW1lIjoiQnJpYW4gRGF1Z2hlcnR5IiwicGljdHVyZSI6Imh0dHBzOi8vbGgzLmdvb2dsZXVzZXJjb250ZW50LmNvbS9hLS9BT2gxNEdnenAyTXNGRGZvbVdMX3VDemRYUWNzeVM3ZGtxTE5ybk90S0QzVXNRPXM5Ni1jIiwiZ2l2ZW5fbmFtZSI6IkJyaWFuIiwiZmFtaWx5X25hbWUiOiJEYXVnaGVydHkiLCJsb2NhbGUiOiJlbiIsImlhdCI6MTYzODk5MTYzOCwiZXhwIjoxNjM4OTk1MjM4LCJqdGkiOiI5YmRkZjE1YWFiNzE2ZDhjYmJmNDYwMmM1YWM3YzViN2VhMDQ5OTA5In0.K3EA-3Adw5HA7O8nJVCsX1HmGWxWzYk3P7ViVBb4H4BoT2-HIgxKlx1mi6jSxIUJGEekjw9MC-nL1B9Asgv1vXTMgoGaNna0UoEHYitySI23E5jaMkExkTSLtxI-ih2tJrA2ggfA9Ekj-JFiMc6MuJnwcfBTlsYWRcZOYVw3QpdTZ_VYfhUu-yERAElZCjaAyEXLtVQegRe-ymScra3r9S92TA33ylMb3WDTlfmDpWL0CDdDzby2asXYpl6GQ7SdSj64s49Yw6mdGELZn5WoJqG7Zr2KwIGXJuSxEo-wGbzxNK-mKAiABcFpYP4KHPEUgYyz3n9Vqn2Tfrgp-g65BQ",
    "session_state": {
      "extraQueryParams": {
        "authuser": "0"
      }
    },
    "first_issued_at": 1638991637982,
    "expires_at": 1638995236982,
    "idpId": "google"
  }

Google Identity সম্পর্কিত পরিষেবার ক্রেডেনশিয়াল

Google Identity Services লাইব্রেরি এগুলি রিটার্ন করে:

  • অথবা অনুমোদনের জন্য ব্যবহার করা হলে একটি অ্যাক্সেস টোকেন:

    {
      "access_token": "ya29.A0ARrdaM_LWSO-uckLj7IJVNSfnUityT0Xj-UCCrGxFQdxmLiWuAosnAKMVQ2Z0LLqeZdeJii3TgULp6hR_PJxnInBOl8UoUwWoqsrGQ7-swxgy97E8_hnzfhrOWyQBmH6zs0_sUCzwzhEr_FAVqf92sZZHphr0g",
      "token_type": "Bearer",
      "expires_in": 3599,
      "scope": "https://www.googleapis.com/auth/calendar.readonly"
    }
    
  • অথবা, যাচাইকরণের জন্য ব্যবহার করা হলে আইডি টোকেন:

    {
      "clientId": "538344653255-758c5h5isc45vgk27d8h8deabovpg6to.apps.googleusercontent.com",
      "credential": "eyJhbGciOiJSUzI1NiIsImtpZCI6ImMxODkyZWI0OWQ3ZWY5YWRmOGIyZTE0YzA1Y2EwZDAzMjcxNGEyMzciLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJodHRwczovL2FjY291bnRzLmdvb2dsZS5jb20iLCJuYmYiOjE2MzkxNTcyNjQsImF1ZCI6IjUzODM0NDY1MzI1NS03NThjNWg1aXNjNDV2Z2syN2Q4aDhkZWFib3ZwZzZ0by5hcHBzLmdvb2dsZXVzZXJjb250ZW50LmNvbSIsInN1YiI6IjExNzcyNjQzMTY1MTk0MzY5ODYwMCIsIm5vbmNlIjoiZm9vYmFyIiwiaGQiOiJnb29nbGUuY29tIiwiZW1haWwiOiJkYWJyaWFuQGdvb2dsZS5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwiYXpwIjoiNTM4MzQ0NjUzMjU1LTc1OGM1aDVpc2M0NXZnazI3ZDhoOGRlYWJvdnBnNnRvLmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwibmFtZSI6IkJyaWFuIERhdWdoZXJ0eSIsInBpY3R1cmUiOiJodHRwczovL2xoMy5nb29nbGV1c2VyY29udGVudC5jb20vYS0vQU9oMTRHZ3pwMk1zRkRmb21XTF91Q3pkWFFjc3lTN2RrcUxOcm5PdEtEM1VzUT1zOTYtYyIsImdpdmVuX25hbWUiOiJCcmlhbiIsImZhbWlseV9uYW1lIjoiRGF1Z2hlcnR5IiwiaWF0IjoxNjM5MTU3NTY0LCJleHAiOjE2MzkxNjExNjQsImp0aSI6IjRiOTVkYjAyZjU4NDczMmUxZGJkOTY2NWJiMWYzY2VhYzgyMmI0NjUifQ.Cr-AgMsLFeLurnqyGpw0hSomjOCU4S3cU669Hyi4VsbqnAV11zc_z73o6ahe9Nqc26kPVCNRGSqYrDZPfRyTnV6g1PIgc4Zvl-JBuy6O9HhClAK1HhMwh1FpgeYwXqrng1tifmuotuLQnZAiQJM73Gl-J_6s86Buo_1AIx5YAKCucYDUYYdXBIHLxrbALsA5W6pZCqqkMbqpTWteix-G5Q5T8LNsfqIu_uMBUGceqZWFJALhS9ieaDqoxhIqpx_89QAr1YlGu_UO6R6FYl0wDT-nzjyeF5tonSs3FHN0iNIiR3AMOHZu7KUwZaUdHg4eYkU-sQ01QNY_11keHROCRQ",
      "select_by": "user"
    }
    

ভুল টোকেন উত্তর

মেয়াদ শেষ হয়ে যাওয়া, তুলে নেওয়া বা ভুল অ্যাক্সেস টোকেন ব্যবহার করে API অনুরোধ করার চেষ্টা করলে, Google-এর থেকে পাওয়া উত্তরের উদাহরণ:

HTTP রেসপন্স হেডার

  www-authenticate: Bearer realm="https://accounts.google.com/", error="invalid_token"

প্রতিক্রিয়ার বডি

  {
    "error": {
      "code": 401,
      "message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https://developers.google.com/identity/sign-in/web/devconsole-project.",
      "errors": [
        {
          "message": "Invalid Credentials",
          "domain": "global",
          "reason": "authError",
          "location": "Authorization",
          "locationType": "header"
        }
      ],
      "status": "UNAUTHENTICATED"
    }
  }