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

এই পৃষ্ঠায় ধরে নেওয়া হয়েছে যে আপনি রিসোর্স ওরিয়েন্টেড ডিজাইন এবং রিসোর্সের নাম সংক্রান্ত ডেভেলপার নির্দেশিকা সম্পর্কে জানেন এবং Google Ads API-এর নির্দিষ্ট প্রয়োগের বিবরণ দিয়ে সেগুলিকে সম্পূর্ণ করে।

রিসোর্স-ওরিয়েন্টেড ডিজাইন

সাধারণত, Google Ads API রিসোর্স-ভিত্তিক ডিজাইন অনুসরণ করে, যা আলাদাভাবে-অ্যাড্রেস করা যায় এমন রিসোর্সের (API-এর বিশেষ্য) কালেকশন হিসেবে মডেল করা হয়। রিসোর্সগুলি তাদের রিসোর্সের নাম দিয়ে রেফারেন্স করা হয় এবং পদ্ধতি (ক্রিয়া বা অপারেশন নামেও পরিচিত) এর একটি ছোট সেট ব্যবহার করে ম্যানিপুলেট করা হয়। এই রিসোর্সের নাম এবং পদ্ধতি, নির্দিষ্ট API ভার্সন প্রিফিক্স-এর সাথে একত্রিত হয়ে REST ইন্টারফেসের URL তৈরি করে। যেমন, এই উদাহরণ URL-কে নিম্নলিখিত সারণী অনুযায়ী এইসব স্বতন্ত্র কম্পোনেন্টে ভেঙে দেখানো যেতে পারে:

https://googleads.googleapis.com/v26/customers/1234567890:mutate

API-এর নির্দিষ্ট ভার্সনের (যেমন, v26) জন্য সব REST URL-এর একটি সাধারণ API ভার্সন প্রিফিক্স থাকে। রিসোর্সের নাম ও পদ্ধতি একসাথে কোন API পরিষেবা কল করা হচ্ছে তা শনাক্ত করে।

Google Ads API-তে কাস্টম পদ্ধতি ব্যাপকভাবে ব্যবহার করা হয়, যা বেশিরভাগ REST API-এর থেকে আলাদা। REST API-তে list, get, create, update এবং delete-এর মতো স্ট্যান্ডার্ড REST পদ্ধতি ব্যবহার করা হয়। Google Ads API-তে কাস্টম পদ্ধতির উদাহরণের মধ্যে search, searchStream ও mutate অন্তর্ভুক্ত।

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

সমস্যা ম্যানেজ করা

কোনও সমস্যা দেখা দিলে তা কীভাবে বিশ্লেষণ ও ডিবাগ করবেন সেই বিষয়ে নির্দেশিকার জন্য API সংক্রান্ত সমস্যা বোঝা দেখুন।

ডিসকভারি ডকুমেন্ট

Google Ads API-তে উপলভ্য পদ্ধতিগুলি সহজে এবং অটোমেটিক খুঁজে পেতে, আপনি প্রতিটি ভার্সনের জন্য প্রকাশিত ডিসকভারি ডকুমেন্ট ব্যবহার করতে পারেন।

এটি https://googleads.googleapis.com/$discovery/rest?version=<API_VERSION>-এ উপলভ্য। যেমন, এটি হল Google Ads API-এর লেটেস্ট ভার্সনের ডিসকভারি ডকুমেন্ট।

ডিসকভারি ডকুমেন্টে Google Ads API-তে ব্যবহৃত সমস্ত পরিষেবা, পদ্ধতি, রিসোর্স এবং এন্টিটি সম্পর্কে তথ্য থাকে, যেমন রেফারেন্স ডকুমেন্টেশন, তবে মেশিনের ক্ষেত্রে গ্রহণযোগ্য, JSON ফর্ম্যাটে।