AdMob API ব্যবহার করা শুরু করা

গুরুত্বপূর্ণ: নতুন ব্যবহারকারীর ভূমিকা ও অনুমতি AdMob API-এর মাধ্যমে রিটার্ন করা ডেটার উপর প্রভাব ফেলবে। আরও জানুন

এই নির্দেশিকা সেইসব ডেভেলপারদের জন্য যারা AdMob API ব্যবহার করে প্রোগ্রাম্যাটিক উপায়ে চান।

Google AdMob API-এর সব কলকে OAuth2-এর মাধ্যমে অনুমোদন করতে হবে যাতে আপনার অ্যাপ ব্যবহারকারীর হয়ে ওয়েব পরিষেবার সাথে ইন্টার‍্যাক্ট করতে পারে। OAuth2 আপনার AdMob API ক্লায়েন্ট অ্যাপকে কোনও ব্যবহারকারীর AdMob অ্যাকাউন্ট অ্যাক্সেস করতে দেয়, এর জন্য ব্যবহারকারীর ইউজারনেম বা পাসওয়ার্ড হ্যান্ডেল বা স্টোর করতে হয় না। অনুমোদনের ওভারভিউ পেতে, অনুমোদন দেখুন।

OAuth2 ক্রেডেনশিয়াল তৈরি করতে এবং আপনার প্রথম অনুরোধ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন।

পূর্বশর্ত

• Google অ্যাকাউন্ট।

• একটি Google AdMob অ্যাকাউন্ট।

• REST সম্পর্কিত প্রাথমিক তথ্য এবং OAuth 2.0-এর মাধ্যমে অনুরোধ অনুমোদন করা সম্পর্কে জানা।

আপনার যাচাইকরণের ধরন নির্ধারণ করুন

আপনার অ্যাপের জন্য কোন যাচাইকরণের ধরন সবচেয়ে উপযুক্ত তা জানতে নিচের টেবিল চেক করুন:

আপনার OAuth2 যাচাইকরণের ধরন বেছে নিন	যদি ...
ডেস্কটপ অ্যাপ	আপনি একটি টপ-লেভেল ম্যানেজার অ্যাকাউন্ট ব্যবহার করে আপনার সব AdMob API অ্যাকাউন্ট ম্যানেজ করছেন। আপনি প্রথমবার ব্যবহারকারী অথবা সবচেয়ে সহজ সেট-আপের মাধ্যমে দ্রুত শুরু করতে চান। আপনার অ্যাপ শুধুমাত্র একটি মেশিন থেকে Google AdMob ব্যবহারকারীদের যাচাই করে।
ওয়েব অ্যাপ	আপনি এমন একজন ব্যবহারকারী হিসেবে প্রমাণ করতে চান যিনি আপনার অ্যাপকে তার AdMob API অ্যাকাউন্ট ডেটা অ্যাক্সেস করার অনুমতি দিতে পারেন। আপনি সহজেই একাধিক অনুমোদনের ক্রেডেনশিয়াল তৈরি করতে চান, যেমন থার্ড-পার্টি অ্যাকাউন্ট ম্যানেজ করার জন্য। আপনার অ্যাপে কলব্যাক URL প্রয়োজন। কলব্যাক URL ডেস্কটপ অ্যাপ ফ্লোতে কাজ করে না।

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

প্রোজেক্ট তৈরি করা

AdMob API ব্যবহার শুরু করতে, আপনাকে প্রথমে Google API Console-এ একটি প্রোজেক্ট তৈরি বা বেছে নিতে হবে এবং সেট-আপ টুল ব্যবহার করে API চালু করতে হবে। এই টুল আপনাকে প্রসেসটি সম্পূর্ণ করতে সাহায্য করে এবং AdMob API অটোমেটিক অ্যাক্টিভেট করে দেয়।

আগে থেকে থাকা প্রোজেক্টের জন্য API চালু করা

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

আপনার প্রোজেক্টের জন্য API চালু করতে:

1. Google API কনসোলে API লাইব্রেরি খুলুন।
2. প্রম্পট করা হলে, একটি প্রোজেক্ট বেছে নিন অথবা নতুন একটি তৈরি করুন। API লাইব্রেরিতে উপলভ্য সব API-এর তালিকা দেওয়া আছে, যেগুলি প্রোডাক্ট ফ্যামিলি ও জনপ্রিয়তার ভিত্তিতে গ্রুপ করা হয়েছে।
3. আপনি যে API চালু করতে চান সেটি তালিকায় দেখতে না পেলে, সেটি খুঁজে পেতে সার্চ ব্যবহার করুন অথবা এটি যে প্রোডাক্ট ফ্যামিলির অন্তর্গত সেটির মধ্যে সব দেখুন বিকল্পে ক্লিক করুন।
4. আপনি যে API চালু করতে চান সেটি বেছে নিন, তারপরে চালু করুন বোতামে ক্লিক করুন।
5. বলা হলে, বিলিং চালু করুন।
6. প্রম্পট করা হলে, API-এর পরিষেবার শর্তাবলী পড়ে তাতে সম্মতি দিন।

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

ইনস্টল করা অ্যাপ ফ্লোর সাথে ব্যবহার করার জন্য OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করার প্রসেস সম্পর্কে নিম্নলিখিত নির্দেশাবলী আপনাকে গাইড করে।

1. ক্লায়েন্ট পৃষ্ঠায় যান।

2. ক্রেডেনশিয়াল তৈরি করুন > OAuth ক্লায়েন্ট আইডি বিকল্পে ক্লিক করুন।

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

   1. আপনার ব্যবহারকারীর ধরন এক্সটার্নাল এবং প্রকাশনার স্ট্যাটাস প্রকাশিত হিসেবে সেট করুন।

   2. অথবা, আপনার ব্যবহারকারীর ধরন এক্সটার্নাল এবং প্রকাশনার স্ট্যাটাস টেস্টিং হিসেবে সেট করুন, তারপরে টেস্ট ব্যবহারকারী যোগ করতে ব্যবহারকারী যোগ করুন বিকল্প বেছে নিন। এর ফলে তারা আপনার OAuth 2.0 ক্লায়েন্ট আইডি ব্যবহার করার অ্যাক্সেস পাবেন।

      আপনার OAuth-এর সম্মতি সংক্রান্ত স্ক্রিন সেট-আপ করা সম্পর্কে অতিরিক্ত তথ্য দেখুন।

3. অ্যাপ্লিকেশনের ধরন হিসেবে ডেস্কটপ অ্যাপ বা ওয়েব অ্যাপ্লিকেশন বেছে নিন, এটিকে একটি নাম দিন, তারপর তৈরি করুন বিকল্পে ক্লিক করুন।

এটি হয়ে গেলে, আপনাকে OAuth 2.0 ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট দেওয়া হবে, যা আপনি JSON ফর্ম্যাটে ডাউনলোড করতে এবং পরে ব্যবহারের জন্য সেভ করতে পারবেন।

একটি অনুরোধ জানান

AdMob API, HTTP ও JSON-এর উপর ভিত্তি করে তৈরি করা হয়েছে, তাই যেকোনও স্ট্যান্ডার্ড HTTP ক্লায়েন্ট এতে অনুরোধ পাঠাতে এবং উত্তর পার্স করতে পারে। তবে, Google API ক্লায়েন্ট লাইব্রেরি আরও ভাল ভাষা ইন্টিগ্রেশন, উন্নত নিরাপত্তা প্রদান করে এবং অনুমোদিত অনুরোধ করার ক্ষেত্রে সহায়তা করে। ক্লায়েন্ট লাইব্রেরি বিভিন্ন প্রোগ্রামিং ভাষায় উপলভ্য; সেগুলি ব্যবহার করে আপনি HTTP অনুরোধ ম্যানুয়ালি সেট-আপ করা ও উত্তর পার্স করার প্রয়োজনীয়তা এড়াতে পারবেন।

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

তৈরি করা OAuth 2.0 ক্রেডেনশিয়াল দিয়ে, আপনি AdMob API ব্যবহার করা শুরু করতে পারবেন। OAuth 2.0 ব্যবহার করে অ্যাক্সেস অনুরোধ করতে, আপনার অ্যাপেরও স্কোপ সংক্রান্ত তথ্য প্রয়োজন:

সুযোগ	অর্থ
https://www.googleapis.com/auth/admob.readonly	সব AdMob ডেটা দেখুন। এর মধ্যে অ্যাকাউন্ট সংক্রান্ত তথ্য, ইনভেন্টরি ও মধ্যস্থতা সেটিংস, রিপোর্ট ও অন্যান্য ডেটা থাকতে পারে। এর মধ্যে পেমেন্ট ও ক্যাম্পেনের বিবরণের মতো সংবেদনশীল ব্যক্তিগত তথ্য অন্তর্ভুক্ত নয়।
https://www.googleapis.com/auth/admob.report	বিজ্ঞাপনের পারফর্ম্যান্স ও উপার্জনের রিপোর্ট দেখুন। প্রকাশক আইডি, টাইমজোন ও ডিফল্ট কারেন্সি কোড দেখুন।

Java, PHP, Python বা curl-এ প্রদত্ত উদাহরণ ব্যবহার করে রিপোর্ট তৈরি করার জন্য আপনার প্রথম অনুরোধ করুন।

শেয়ার করা টোকেন তুলে নেওয়া

আপনি দু'টি উপায়ে শেয়ার করা টোকেন প্রত্যাহার করতে পারবেন:

1. আপনার Google অ্যাকাউন্ট অনুমতি পৃষ্ঠায় নেভিগেট করুন এবং প্রাসঙ্গিক প্রোজেক্ট থেকে অ্যাক্সেস প্রত্যাহার করুন।

2. অথবা, আপনি Google Identity API ব্যবহার করে ওয়েব অ্যাপ্লিকেশন টোকেন প্রত্যাহার করতে পারেন।