সরাসরি অনুরোধ করুন

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

কলিং স্টাইল

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

REST শব্দটি " রিপ্রেজেন্টেশনাল স্টেট ট্রান্সফার " এর জন্য সংক্ষিপ্ত। Google API-এর প্রসঙ্গে, এটি Google দ্বারা সংরক্ষিত ডেটার উপস্থাপনা পুনরুদ্ধার এবং সংশোধন করার জন্য HTTP ক্রিয়া ব্যবহারকে বোঝায়।

একটি RESTful সিস্টেমে, সম্পদ একটি ডেটা স্টোরে সংরক্ষণ করা হয়; একটি ক্লায়েন্ট একটি অনুরোধ পাঠায় যে সার্ভার একটি নির্দিষ্ট ক্রিয়া সম্পাদন করে (যেমন একটি সংস্থান তৈরি করা, পুনরুদ্ধার করা, আপডেট করা বা মুছে ফেলা), এবং সার্ভার ক্রিয়াটি সম্পাদন করে এবং একটি প্রতিক্রিয়া পাঠায়, প্রায়শই নির্দিষ্ট সংস্থানের উপস্থাপনা আকারে।

Google-এর RESTful API-এ, ক্লায়েন্ট একটি HTTP ক্রিয়া যেমন POST , GET , PUT , বা DELETE ব্যবহার করে একটি ক্রিয়া নির্দিষ্ট করে৷ এটি নিম্নলিখিত ফর্মের একটি বিশ্বব্যাপী-অনন্য URI দ্বারা একটি সংস্থান নির্দিষ্ট করে:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

যেহেতু সমস্ত API সংস্থানগুলিতে অনন্য HTTP- অ্যাক্সেসযোগ্য URI রয়েছে, REST ডেটা ক্যাশিং সক্ষম করে এবং ওয়েবের বিতরণ করা অবকাঠামোর সাথে কাজ করার জন্য অপ্টিমাইজ করা হয়৷

আপনি HTTP 1.1 স্ট্যান্ডার্ড ডকুমেন্টেশনে পদ্ধতির সংজ্ঞাগুলি দরকারী খুঁজে পেতে পারেন; তারা GET , POST , PUT , এবং DELETE এর স্পেসিফিকেশন অন্তর্ভুক্ত করে।

অ্যাডসেন্স ম্যানেজমেন্ট এপিআই-এ বিশ্রাম নিন

সমর্থিত ক্রিয়াকলাপগুলি সরাসরি REST HTTP ক্রিয়াতে ম্যাপ করে, যেমনটি AdSense ম্যানেজমেন্ট API অপারেশনগুলিতে বর্ণিত হয়েছে।

AdSense ম্যানেজমেন্ট API URI-এর জন্য নির্দিষ্ট ফর্ম্যাট হল:

https://adsense.googleapis.com/v2/resourceID?parameters

যেখানে resourceID হল একটি বিজ্ঞাপন ক্লায়েন্ট, বিজ্ঞাপন ইউনিট, url চ্যানেল, কাস্টম চ্যানেল বা রিপোর্ট সংগ্রহের শনাক্তকারী এবং parameters হল যেকোন প্যারামিটার যা ক্যোয়ারীতে প্রযোজ্য।

resourceID পাথ এক্সটেনশনের ফর্ম্যাট আপনাকে সেই সংস্থান সনাক্ত করতে দেয় যার উপর আপনি বর্তমানে কাজ করছেন, উদাহরণস্বরূপ:

https://adsense.googleapis.com/v2/accounts/account_id/adclients
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/adunits
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/adunits/adUnitId
https://adsense.googleapis.com/v2/accounts/account_id/adclients/adClientId/urlchannels
...

API-এ প্রতিটি সমর্থিত অপারেশনের জন্য ব্যবহৃত URI-এর সম্পূর্ণ সেট AdSense ম্যানেজমেন্ট API রেফারেন্স ডকুমেন্টে সংক্ষিপ্ত করা হয়েছে।

AdSense ম্যানেজমেন্ট API-এ এটি কীভাবে কাজ করে তার কয়েকটি উদাহরণ এখানে দেওয়া হল।

বিজ্ঞাপন ক্লায়েন্টদের তালিকা করুন:

GET https://adsense.googleapis.com/v2/accounts/account_id/adclients/

বিজ্ঞাপন ক্লায়েন্ট ca-pub-1234567890123456-এ বিজ্ঞাপন ইউনিট তালিকাভুক্ত করুন: 

GET https://adsense.googleapis.com/v2/accounts/account_id/adclients/ca-pub-1234567890123456/adunits

ডেটা বিন্যাস

JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।

অনুরোধ অনুমোদন

মনে রাখবেন যে AdSense পরিষেবা অ্যাকাউন্টগুলিকে সমর্থন করে না, পরিবর্তে আপনাকে অবশ্যই ইনস্টল করা অ্যাপ্লিকেশন ফ্লো ব্যবহার করতে হবে৷

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

অনুমোদন প্রোটোকল সম্পর্কে

অনুরোধ অনুমোদন করতে আপনার অ্যাপ্লিকেশন অবশ্যই OAuth 2.0 ব্যবহার করবে। অন্য কোন অনুমোদন প্রোটোকল সমর্থিত হয় না. যদি আপনার অ্যাপ্লিকেশন Google এর সাথে সাইন ইন ব্যবহার করে, তবে অনুমোদনের কিছু দিক আপনার জন্য পরিচালনা করা হয়।

OAuth 2.0 এর মাধ্যমে অনুরোধ অনুমোদন করা হচ্ছে

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

এই প্রক্রিয়াটি একটি OAuth ক্লায়েন্ট আইডি দিয়ে সহজতর করা হয়।

একটি OAuth ক্লায়েন্ট আইডি পান

অথবা শংসাপত্র পৃষ্ঠায় একটি তৈরি করুন।

OAuth 2.0-এর জন্য অনুমোদন প্রক্রিয়ার বিশদ বিবরণ বা "প্রবাহ" আপনি কোন ধরনের অ্যাপ্লিকেশন লিখছেন তার উপর নির্ভর করে কিছুটা পরিবর্তিত হয়। নিম্নলিখিত সাধারণ প্রক্রিয়া সব ধরনের আবেদনের ক্ষেত্রে প্রযোজ্য:

  1. যখন আপনার অ্যাপ্লিকেশনটির ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন হয়, তখন এটি Google কে অ্যাক্সেসের একটি নির্দিষ্ট সুযোগের জন্য জিজ্ঞাসা করে।
  2. Google ব্যবহারকারীর কাছে একটি সম্মতি স্ক্রীন প্রদর্শন করে, তাদের কিছু ডেটা অনুরোধ করার জন্য আপনার আবেদনকে অনুমোদন করতে বলে।
  3. যদি ব্যবহারকারী অনুমোদন করেন, তাহলে Google আপনার অ্যাপ্লিকেশনকে একটি স্বল্পকালীন অ্যাক্সেস টোকেন দেয়।
  4. আপনার অ্যাপ্লিকেশন ব্যবহারকারীর ডেটা অনুরোধ করে, অনুরোধে অ্যাক্সেস টোকেন সংযুক্ত করে।
  5. যদি Google নির্ধারণ করে যে আপনার অনুরোধ এবং টোকেন বৈধ, এটি অনুরোধ করা ডেটা ফেরত দেয়।

কিছু প্রবাহে অতিরিক্ত পদক্ষেপ অন্তর্ভুক্ত থাকে, যেমন নতুন অ্যাক্সেস টোকেন অর্জন করতে রিফ্রেশ টোকেন ব্যবহার করে। বিভিন্ন ধরনের অ্যাপ্লিকেশনের জন্য প্রবাহ সম্পর্কে বিস্তারিত তথ্যের জন্য, Google এর OAuth 2.0 ডকুমেন্টেশন দেখুন।

AdSense ম্যানেজমেন্ট API-এর জন্য এখানে OAuth 2.0 স্কোপের তথ্য রয়েছে:

ব্যাপ্তি অর্থ
https://www.googleapis.com/auth/adsense অ্যাডসেন্স ডেটা পড়ুন/লিখুন।
https://www.googleapis.com/auth/adsense.readonly অ্যাডসেন্স ডেটাতে শুধুমাত্র-পঠন অ্যাক্সেস।

OAuth 2.0 ব্যবহার করে অ্যাক্সেসের অনুরোধ করার জন্য, আপনার অ্যাপ্লিকেশনের সুযোগ তথ্যের প্রয়োজন, সেইসাথে আপনি যখন আপনার আবেদনটি নিবন্ধন করেন তখন Google সরবরাহ করে এমন তথ্য (যেমন ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট)।

টিপ: Google APIs ক্লায়েন্ট লাইব্রেরিগুলি আপনার জন্য কিছু অনুমোদন প্রক্রিয়া পরিচালনা করতে পারে৷ তারা বিভিন্ন প্রোগ্রামিং ভাষার জন্য উপলব্ধ; আরও বিস্তারিত জানার জন্য লাইব্রেরি এবং নমুনা সহ পৃষ্ঠাটি দেখুন।

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

চূড়ান্ত ধাপ হল API অনুরোধ করা। নির্দিষ্ট তথ্যের জন্য রেফারেন্স ডকুমেন্টেশন দেখুন.