এই নির্দেশিকাটি বর্ণনা করে যে কীভাবে একটি অ্যাপ্লিকেশন ব্যবহারকারী মুছে ফেলার API-তে অনুরোধ অনুমোদন করে।
অনুরোধ অনুমোদন করুন
ব্যবহারকারীরা Google Analytics ওয়েবসাইটে তাদের অ্যাকাউন্টের তথ্য দেখতে পাওয়ার আগে, তাদের প্রথমে তাদের Google অ্যাকাউন্টে সাইন ইন করতে হবে। একইভাবে, যখন ব্যবহারকারীরা প্রথমবার আপনার অ্যাপ্লিকেশন অ্যাক্সেস করেন, তখন তাদের ডেটা অ্যাক্সেস করার জন্য আপনার অ্যাপ্লিকেশনটিকে অনুমোদন করতে হবে।
আপনার অ্যাপ্লিকেশনটি Analytics API-তে পাঠানো প্রতিটি অনুরোধে একটি অনুমোদন টোকেন অন্তর্ভুক্ত থাকতে হবে। টোকেনটি Google-এর কাছে আপনার অ্যাপ্লিকেশনটিও শনাক্ত করে।
অনুমোদন প্রোটোকল সম্পর্কে
অনুরোধ অনুমোদনের জন্য আপনার অ্যাপ্লিকেশনকে OAuth 2.0 ব্যবহার করতে হবে। অন্য কোনও অনুমোদন প্রোটোকল সমর্থিত নয়। যদি আপনার অ্যাপ্লিকেশনটি Sign In With Google ব্যবহার করে, তাহলে অনুমোদনের কিছু দিক আপনার জন্য পরিচালনা করা হবে।
OAuth 2.0 ব্যবহার করে অনুরোধ অনুমোদন করা
অ্যানালিটিক্স এপিআই-তে করা সমস্ত অনুরোধ অবশ্যই একজন অনুমোদিত ব্যবহারকারী দ্বারা অনুমোদিত হতে হবে।
OAuth 2.0 এর জন্য অনুমোদন প্রক্রিয়া, অথবা "প্রবাহ" এর বিশদ বিবরণ আপনি কোন ধরণের অ্যাপ্লিকেশন লিখছেন তার উপর নির্ভর করে কিছুটা পরিবর্তিত হয়। নিম্নলিখিত সাধারণ প্রক্রিয়াটি সমস্ত ধরণের অ্যাপ্লিকেশনের ক্ষেত্রে প্রযোজ্য:
- যখন আপনি আপনার অ্যাপ্লিকেশন তৈরি করেন, তখন আপনি Google API Console ব্যবহার করে এটি নিবন্ধন করেন। এরপর Google আপনার পরে প্রয়োজনীয় তথ্য প্রদান করে, যেমন একটি ক্লায়েন্ট আইডি এবং একটি ক্লায়েন্ট সিক্রেট।
- গুগল এপিআই কনসোলে অ্যানালিটিক্স এপিআই সক্রিয় করুন। (যদি এপিআই কনসোলে তালিকাভুক্ত না থাকে, তাহলে এই ধাপটি এড়িয়ে যান।)
- যখন আপনার অ্যাপ্লিকেশনটি ব্যবহারকারীর ডেটা অ্যাক্সেসের প্রয়োজন হয়, তখন এটি গুগলের কাছে একটি নির্দিষ্ট অ্যাক্সেসের সুযোগের জন্য অনুরোধ করে।
- গুগল ব্যবহারকারীকে একটি সম্মতি স্ক্রিন প্রদর্শন করে, যাতে তাদের কিছু ডেটা অনুরোধ করার জন্য আপনার আবেদনটি অনুমোদন করতে বলা হয়।
- যদি ব্যবহারকারী অনুমোদন করেন, তাহলে গুগল আপনার অ্যাপ্লিকেশনটিকে একটি স্বল্পস্থায়ী অ্যাক্সেস টোকেন দেয়।
- আপনার অ্যাপ্লিকেশনটি ব্যবহারকারীর ডেটা অনুরোধ করে, অনুরোধের সাথে অ্যাক্সেস টোকেন সংযুক্ত করে।
- যদি Google নির্ধারণ করে যে আপনার অনুরোধ এবং টোকেনটি বৈধ, তাহলে এটি অনুরোধ করা ডেটা ফেরত দেয়।
কিছু প্রবাহে অতিরিক্ত পদক্ষেপ অন্তর্ভুক্ত থাকে, যেমন নতুন অ্যাক্সেস টোকেন অর্জনের জন্য রিফ্রেশ টোকেন ব্যবহার করা। বিভিন্ন ধরণের অ্যাপ্লিকেশনের প্রবাহ সম্পর্কে বিস্তারিত তথ্যের জন্য, Google এর OAuth 2.0 ডকুমেন্টেশন দেখুন।
Analytics API-এর জন্য OAuth 2.0 স্কোপের তথ্য এখানে দেওয়া হল:
| ব্যাপ্তি | অর্থ |
|---|---|
https://www.googleapis.com/auth/analytics.user.deletion | ব্যবহারকারী মুছে ফেলার API ব্যবহার করে ডেটা মুছে ফেলুন। |
OAuth 2.0 ব্যবহার করে অ্যাক্সেসের অনুরোধ করার জন্য, আপনার অ্যাপ্লিকেশনটির স্কোপ তথ্যের পাশাপাশি আপনার অ্যাপ্লিকেশন নিবন্ধনের সময় Google দ্বারা সরবরাহ করা তথ্য (যেমন ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট) প্রয়োজন।
পরামর্শ: গুগল এপিআই ক্লায়েন্ট লাইব্রেরিগুলি আপনার জন্য কিছু অনুমোদন প্রক্রিয়া পরিচালনা করতে পারে। এগুলি বিভিন্ন প্রোগ্রামিং ভাষার জন্য উপলব্ধ; আরও বিস্তারিত জানার জন্য লাইব্রেরি এবং নমুনা সহ পৃষ্ঠাটি দেখুন।
সাধারণ OAuth 2.0 প্রবাহ
নির্দিষ্ট OAuth 2.0 প্রবাহের জন্য সাধারণ ব্যবহারের ক্ষেত্রে নিম্নলিখিত তালিকাগুলি দেওয়া হয়েছে:
ওয়েব সার্ভার
এই প্রবাহটি ব্যবহারকারীর Google Analytics ডেটার স্বয়ংক্রিয়, অফলাইন বা নির্ধারিত অ্যাক্সেসের জন্য ভালো।
উদাহরণ:
- সর্বশেষ Google Analytics ডেটা সহ ব্যবহারকারীর ড্যাশবোর্ড স্বয়ংক্রিয়ভাবে আপডেট করা।
ক্লায়েন্ট-সাইড
এই প্রবাহটি এমন অ্যাপ্লিকেশনগুলির জন্য আদর্শ যখন ব্যবহারকারীরা ব্রাউজারের মধ্যে তাদের Google Analytics ডেটা অ্যাক্সেস করার জন্য অ্যাপ্লিকেশনের সাথে সরাসরি যোগাযোগ করে। এটি সার্ভার-সাইড ক্ষমতার প্রয়োজনীয়তা দূর করে, তবে এটি স্বয়ংক্রিয়, অফলাইন বা নির্ধারিত প্রতিবেদনকে অবাস্তব করে তোলে।
উদাহরণ:
- একটি ব্রাউজার ভিত্তিক রিপোর্টিং টুল যেমন অ্যানালিটিক্স কোয়েরি এক্সপ্লোরার ।
ইনস্টল করা অ্যাপ্লিকেশন
এই ফ্লোটি এমন অ্যাপ্লিকেশনের জন্য যা প্যাকেজ হিসেবে বিতরণ করা হয় এবং ব্যবহারকারী দ্বারা ইনস্টল করা হয়। এই ফ্লোটির জন্য প্রমাণীকরণ ফ্লো সম্পূর্ণ করার জন্য অ্যাপ্লিকেশন বা ব্যবহারকারীর একটি ব্রাউজারে অ্যাক্সেস থাকা প্রয়োজন।
উদাহরণ:
- পিসি বা ম্যাকে একটি ডেস্কটপ উইজেট।
- কন্টেন্ট ম্যানেজমেন্ট সিস্টেমের জন্য একটি প্লাগইন — ওয়েব সার্ভার বা ক্লায়েন্ট-সাইডের তুলনায় এই প্রবাহের সুবিধা হল যে আপনার অ্যাপ্লিকেশনের জন্য একটি একক API কনসোল প্রকল্প ব্যবহার করা যেতে পারে। এটি একত্রিত প্রতিবেদন এবং ব্যবহারকারীদের জন্য একটি সহজ ইনস্টলেশনের অনুমতি দেয়।
পরিষেবা অ্যাকাউন্ট
আপনার নিজের অ্যাকাউন্টের জন্য Google Analytics ডেটাতে স্বয়ংক্রিয়, অফলাইন বা নির্ধারিত অ্যাক্সেসের জন্য পরিষেবা অ্যাকাউন্টগুলি কার্যকর। উদাহরণস্বরূপ, আপনার নিজস্ব Google Analytics ডেটার একটি লাইভ ড্যাশবোর্ড তৈরি করা এবং এটি অন্যান্য ব্যবহারকারীদের সাথে ভাগ করে নেওয়া।
অ্যানালিটিক্স এপিআই ব্যবহার শুরু করার জন্য, আপনাকে প্রথমে সেটআপ টুলটি ব্যবহার করতে হবে, যা আপনাকে গুগল এপিআই কনসোলে একটি প্রকল্প তৈরি এবং এপিআই সক্ষম করার জন্য গাইড করে।
একটি নতুন পরিষেবা অ্যাকাউন্ট সেট আপ করতে, নিম্নলিখিতগুলি করুন:
- ক্রেডেনশিয়াল তৈরি করুন > পরিষেবা অ্যাকাউন্ট কী ক্লিক করুন।
- পরিষেবা অ্যাকাউন্টের পাবলিক/প্রাইভেট কী একটি স্ট্যান্ডার্ড P12 ফাইল হিসেবে ডাউনলোড করবেন, নাকি একটি JSON ফাইল হিসেবে ডাউনলোড করবেন যা একটি Google API ক্লায়েন্ট লাইব্রেরি দ্বারা লোড করা যেতে পারে তা বেছে নিন।
আপনার নতুন পাবলিক/প্রাইভেট কী জোড়া তৈরি করা হয় এবং আপনার মেশিনে ডাউনলোড করা হয়; এটি এই কী-এর একমাত্র কপি হিসেবে কাজ করে। এটি নিরাপদে সংরক্ষণের জন্য আপনার দায়িত্ব।
সমস্যা সমাধান
এই পরিস্থিতিতে আপনার অনুমোদন ব্যর্থ হয়:
যদি আপনার
access_tokenমেয়াদ শেষ হয়ে যায় অথবা আপনি যদি API এর জন্য ভুল স্কোপ ব্যবহার করেন তবে আপনি একটি401স্ট্যাটাস কোড পাবেন।যদি অনুমোদিত ব্যবহারকারীর প্রোফাইল ভিউতে অ্যাক্সেস না থাকে, তাহলে আপনি একটি
403স্ট্যাটাস কোড পাবেন। নিশ্চিত করুন যে আপনি সঠিক ব্যবহারকারীর সাথে অনুমোদিত এবং আপনার নির্বাচিত প্রোফাইলটি তাদের কাছে আছে।
OAuth 2.0 খেলার মাঠ
এই টুলটি আপনাকে একটি ওয়েব ইন্টারফেসের মাধ্যমে সম্পূর্ণ অনুমোদন প্রবাহের মধ্য দিয়ে যেতে দেয়। এই টুলটি একটি অনুমোদিত কোয়েরি তৈরির জন্য প্রয়োজনীয় সমস্ত HTTP অনুরোধ শিরোনামও প্রদর্শন করে। যদি আপনি আপনার নিজস্ব অ্যাপ্লিকেশনে কাজ করার জন্য অনুমোদন না পান, তাহলে আপনার OAuth 2.0 খেলার মাঠের মাধ্যমে এটি কাজ করার চেষ্টা করা উচিত। তারপর আপনি খেলার মাঠের HTTP শিরোনাম এবং অনুরোধের তুলনা করতে পারেন আপনার অ্যাপ্লিকেশনটি Google Analytics-এ যা পাঠাচ্ছে তার সাথে। এই চেকটি আপনার অনুরোধগুলি সঠিকভাবে ফর্ম্যাট করার একটি সহজ উপায়।
অবৈধ অনুদান
যখন আপনি একটি রিফ্রেশ টোকেন ব্যবহার করার চেষ্টা করেন, তখন নিম্নলিখিতটি আপনাকে একটি invalid_grant ত্রুটি ফেরত পাঠায়:
- আপনার সার্ভারের ঘড়ি নেটওয়ার্ক টাইম প্রোটোকল - NTP এর সাথে সিঙ্ক্রোনাইজ নয়।
- রিফ্রেশ টোকেনের সীমা অতিক্রম করা হয়েছে।
একটি একক Google Analytics অ্যাকাউন্ট অ্যাক্সেস করার জন্য অ্যাপ্লিকেশনগুলি একাধিক রিফ্রেশ টোকেনের অনুরোধ করতে পারে।
উদাহরণস্বরূপ, যদি কোনও ব্যবহারকারী একাধিক মেশিনে একটি অ্যাপ্লিকেশন ইনস্টল করতে চান এবং একই Google Analytics অ্যাকাউন্ট অ্যাক্সেস করতে চান, তাহলে প্রতিটি মেশিনের জন্য একটি পৃথক টোকেন প্রয়োজন হবে। যখন রিফ্রেশ টোকেনের সংখ্যা সীমা অতিক্রম করে, তখন পুরানো টোকেনগুলি অবৈধ হয়ে যায়। যদি অ্যাপ্লিকেশনটি একটি অবৈধ রিফ্রেশ টোকেন ব্যবহার করার চেষ্টা করে, তাহলে একটি invalid_grant ত্রুটি প্রতিক্রিয়া ফিরে আসে।
OAuth 2.0 ক্লায়েন্ট এবং Google Analytics অ্যাকাউন্টের প্রতিটি অনন্য জোড়ার জন্য সীমা হল 25টি রিফ্রেশ টোকেন । যদি অ্যাপ্লিকেশনটি একই ক্লায়েন্ট/অ্যাকাউন্ট জোড়ার জন্য রিফ্রেশ টোকেনের অনুরোধ করতে থাকে, তাহলে 26তম টোকেন জারি করার পরে, পূর্বে জারি করা প্রথম রিফ্রেশ টোকেনটি অবৈধ হয়ে যাবে। 27তম অনুরোধ করা রিফ্রেশ টোকেনটি পূর্বে জারি করা দ্বিতীয় টোকেনটিকে অবৈধ করে দেবে ইত্যাদি।