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