এই পৃষ্ঠাটি রিসোর্স ওরিয়েন্টেড ডিজাইন এবং রিসোর্স নেমস ডেভেলপার গাইডগুলির সাথে পরিচিতি ধরে নেয় এবং Google Ads API-এর নির্দিষ্ট বাস্তবায়ন বিবরণ দিয়ে সেগুলিকে পরিপূরক করে।
সম্পদ-ভিত্তিক নকশা
সাধারণত, Google Ads API একটি রিসোর্স-ভিত্তিক নকশা অনুসরণ করে, যা পৃথকভাবে ঠিকানাযোগ্য রিসোর্স (API-এর বিশেষ্য ) সংগ্রহ হিসাবে মডেল করা হয়। রিসোর্সগুলিকে তাদের রিসোর্স নামের সাথে উল্লেখ করা হয় এবং পদ্ধতির একটি ছোট সেট (যা ক্রিয়া বা ক্রিয়াকলাপ নামেও পরিচিত) ব্যবহার করে ম্যানিপুলেট করা হয়।
এই রিসোর্স নাম এবং পদ্ধতিগুলি , একটি নির্দিষ্ট API সংস্করণ প্রিফিক্সের সাথে মিলিত হয়ে, REST ইন্টারফেসের URL গুলি তৈরি করে। উদাহরণস্বরূপ, নীচের URL টি নিম্নলিখিত টেবিল অনুসারে এই পৃথক উপাদানগুলিতে বিভক্ত করা যেতে পারে:
https://googleads.googleapis.com/v22/customers/1234567890:mutate
| API সংস্করণ উপসর্গ | রিসোর্সের নাম (আপেক্ষিক) | পদ্ধতি |
|---|---|---|
https://googleads.googleapis.com/v22 | customers/1234567890 | mutate |
API-এর একটি নির্দিষ্ট সংস্করণের (যেমন, v22 ) সমস্ত REST URL-এ একটি সাধারণ API সংস্করণ প্রিফিক্স থাকে। রিসোর্সের নাম এবং পদ্ধতি একসাথে সনাক্ত করে যে কোন API পরিষেবাটি কল করা হচ্ছে।
Google Ads API কাস্টম পদ্ধতির ব্যাপক ব্যবহার করে, যা বেশিরভাগ ঐতিহ্যবাহী REST API-এর বিপরীতে, যা list , get , create , update এবং delete মতো স্ট্যান্ডার্ড REST পদ্ধতি ব্যবহার করে। Google Ads API-তে কাস্টম পদ্ধতির উদাহরণগুলির মধ্যে রয়েছে search , searchStream এবং mutate ।
নিম্নলিখিত পৃষ্ঠাগুলিতে Google Ads API-এর রিসোর্স নাম , পরিষেবা পদ্ধতি এবং JSON নামকরণের নিয়মাবলী সম্পর্কে আরও বিশদ বিবরণ দেওয়া হয়েছে যাতে REST ইন্টারফেস এন্ডপয়েন্টগুলি সংজ্ঞায়িত করার জন্য এগুলি কীভাবে একসাথে ব্যবহার করা হয় তা বোঝা যায়।
আবিষ্কারের নথি
Google Ads API-তে উপলব্ধ পদ্ধতিগুলি আবিষ্কারের সুবিধার্থে এবং স্বয়ংক্রিয় করার জন্য, আপনি প্রতিটি সংস্করণের জন্য প্রকাশিত আবিষ্কার নথি ব্যবহার করতে পারেন।
এটি https://googleads.googleapis.com/$discovery/rest?version=<API_VERSION> এ উপলব্ধ। উদাহরণস্বরূপ, এটি Google Ads API এর সর্বশেষ সংস্করণের জন্য আবিষ্কারের নথি।
আবিষ্কারের নথিতে Google Ads API-তে ব্যবহৃত সমস্ত পরিষেবা, পদ্ধতি, সংস্থান এবং সত্তা সম্পর্কে তথ্য রয়েছে, যেমন রেফারেন্স ডকুমেন্টেশন , কিন্তু একটি মেশিন-পঠনযোগ্য, JSON ফর্ম্যাটে।