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

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

কলিং স্টাইল

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

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

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

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

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

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

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

AdSense ম্যানেজমেন্ট API-তে REST করুন

সমর্থিত ক্রিয়াকলাপগুলি সরাসরি REST HTTP ক্রিয়াপদের সাথে ম্যাপ করে।

AdSense Management 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 Management API রেফারেন্স ডকুমেন্টে সংক্ষেপে দেওয়া হয়েছে।

AdSense Management 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 পরিষেবা অ্যাকাউন্ট সমর্থন করে না, পরিবর্তে আপনাকে ইনস্টল করা অ্যাপ্লিকেশন ফ্লো ব্যবহার করতে হবে।

আপনার আবেদন AdSense Management API-তে পাঠানো প্রতিটি অনুরোধে একটি অনুমোদন টোকেন অন্তর্ভুক্ত থাকতে হবে। টোকেনটি Google-এর কাছে আপনার আবেদনকেও শনাক্ত করে।

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

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

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

AdSense Management API-তে করা সমস্ত অনুরোধ অবশ্যই একজন অনুমোদিত ব্যবহারকারী দ্বারা অনুমোদিত হতে হবে।

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

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

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

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

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

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

AdSense Management API-এর OAuth 2.0 স্কোপের তথ্য এখানে দেওয়া হল:

ব্যাপ্তি	অর্থ
https://www.googleapis.com/auth/adsense	AdSense ডেটা পড়ার/লেখার অ্যাক্সেস।
https://www.googleapis.com/auth/adsense.readonly	AdSense ডেটাতে কেবল পঠনযোগ্য অ্যাক্সেস।

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

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

অনুরোধ করা

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