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