REST ইন্টারফেস ডিজাইন

এই পৃষ্ঠাটি রিসোর্স ওরিয়েন্টেড ডিজাইন এবং রিসোর্স নেম ডেভেলপার গাইডের সাথে পরিচিতি অনুমান করে এবং অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং এপিআই-এর সুনির্দিষ্ট বাস্তবায়নের বিবরণ দিয়ে তাদের পরিপূরক করে।

সম্পদ-ভিত্তিক নকশা

সাধারণত, Search Ads 360 Reporting API একটি রিসোর্স-ভিত্তিক ডিজাইন অনুসরণ করে, যা পৃথকভাবে-ঠিকানাযোগ্য সম্পদের সংগ্রহ হিসাবে মডেল করা হয় (এপিআই-এর বিশেষ্য )। রিসোর্সগুলিকে তাদের রিসোর্সের নামের সাথে উল্লেখ করা হয় এবং একটি ছোট সেট পদ্ধতি ব্যবহার করে ব্যবহার করা হয় ( যা ক্রিয়া বা অপারেশন নামেও পরিচিত)।

এই রিসোর্সের নাম এবং পদ্ধতিগুলি , একটি নির্দিষ্ট API সংস্করণ উপসর্গের সাথে মিলিত, REST ইন্টারফেসের URL গুলি নিয়ে গঠিত। উদাহরণস্বরূপ, নীচের সারণী অনুসারে নীচের URLটিকে এই পৃথক উপাদানগুলিতে বিভক্ত করা যেতে পারে:

https://searchads360.googleapis.com/v0/customers/1234567890/searchAds360:search
API সংস্করণ উপসর্গ সম্পদের নাম (আত্মীয়) পদ্ধতি
https://searchads360.googleapis.com/v0 customers/1234567890 search

API এর একটি নির্দিষ্ট সংস্করণের জন্য সমস্ত REST URL (যেমন, v0 ) একটি সাধারণ API সংস্করণ উপসর্গ ভাগ করে। সম্পদের নাম এবং পদ্ধতি একসাথে সনাক্ত করে যে কোন API পরিষেবাটি বলা হচ্ছে।

Search Ads 360 Reporting API কাস্টম পদ্ধতির ব্যাপক ব্যবহার করে, বেশিরভাগ প্রথাগত REST API-এর বিপরীতে যেগুলি স্ট্যান্ডার্ড REST পদ্ধতি যেমন list এবং get . অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API-এ দুটি কাস্টম পদ্ধতি রয়েছে: search এবং searchStream

নিম্নলিখিত পৃষ্ঠাগুলি অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API-এর সংস্থানগুলির নাম , পরিষেবা পদ্ধতি এবং JSON নামকরণের রীতিগুলি সম্পর্কে আরও বিশদ বিবরণে যায় যাতে তারা কীভাবে REST ইন্টারফেস এন্ডপয়েন্টগুলিকে সংজ্ঞায়িত করতে একসাথে ব্যবহার করা হয় তা ব্যাখ্যা করে৷