Google Ads API Explorer

Google Ads API এক্সপ্লোরার হল একটি ইন্টার‍্যাক্টিভ এক্সিকিউশন এনভায়রনমেন্ট যা আপনাকে সরাসরি আপনার ব্রাউজার থেকে লাইভ API অনুরোধ তৈরি করতে এবং পাঠাতে দেয়। রেফারেন্স ডকুমেন্টেশনের মধ্যে এম্বেড করা, এটি OAuth 2.0 যাচাইকরণ এবং JSON পেলোড ফর্ম্যাটিংয়ের জটিলতাগুলি ম্যানেজ করে, যা আপনাকে কোডের একটি লাইনও না লিখে নির্দিষ্ট পরিষেবা এবং পদ্ধতিগুলি পরীক্ষা করার অনুমতি দেয়।

সুবিধা

  • নো-কোড টেস্টিং: লোকাল ডেভেলপমেন্ট এনভায়রনমেন্ট সেট-আপ না করেই সরাসরি ডকুমেন্টেশন থেকে লাইভ API কল (রিড ও রাইট, দুটিই) এক্সিকিউট করুন।
  • প্রোটোকল ডিসকভারি: API কীভাবে কাজ করে তা বুঝতে HTTP অনুরোধ ও উত্তরের সঠিক স্ট্রাকচার দেখুন।
  • লো-ফ্রিকশন প্রোটোটাইপিং: আপনার অ্যাপ্লিকেশনে লজিক প্রয়োগ করার ঠিক আগে এন্ডপয়েন্ট আচরণ যাচাই করুন এবং র API প্রতিক্রিয়াগুলি পরীক্ষা করুন।
  • সহজ যাচাইকরণ: টুলটি OAuth 2.0 ফ্লো অটোমেটিক ম্যানেজ করে, যার ফলে আপনি ক্রেডেনশিয়াল ম্যানেজমেন্টের পরিবর্তে API অনুরোধে মনোযোগ দিতে পারেন।

শুরু করুন

  1. ডকুমেন্টেশনে নেভিগেট করুন: রেফারেন্স ডকুমেন্টেশন বিকল্পে যান এবং আপনি যে পরিষেবা ও পদ্ধতি পরীক্ষা করতে চান সেটি বেছে নিন, যেমন GoogleAdsService/Search।
  2. এক্সপ্লোরার খুলুন: পৃষ্ঠার ডানদিকে এই পদ্ধতি ব্যবহার করে দেখুন প্যানেলটি খুঁজুন।
  3. অনুরোধ কনফিগার করুন:
    • প্রয়োজনীয় অনুরোধের প্যারামিটার লিখুন, যেমন customerId এবং হেডার বিকল্পটি বড় করে দেখুন যাতে ঐচ্ছিক HTTP হেডার প্রদান করা যায়, যেমন login-customer-id (শুধুমাত্র ম্যানেজার অ্যাকাউন্টের মাধ্যমে কোনও অ্যাকাউন্ট অ্যাক্সেস করার সময় প্রয়োজন হয়)। মনে রাখবেন যে ডেভেলপার টোকেন (developer-token) ৯ সেপ্টেম্বর, ২০২৬ তারিখে বন্ধ করে দেওয়া হয়েছে এবং API সার্ভার এগুলি উপেক্ষা করে, যদিও ফর্মের মাধ্যমে প্রম্পট করা হলে আপনি এখনও কোনও ভ্যালু লিখতে পারেন।
    • পদ্ধতির জন্য পেলোড প্রয়োজন হলে, যেমন search বা mutate অপারেশনের জন্য, ইন্টার‍্যাক্টিভ JSON এডিটর ব্যবহার করে অনুরোধের বডি নির্দিষ্ট করুন।
  4. এক্সিকিউট করুন: অনুরোধ পাঠাতে এক্সিকিউট করুন বিকল্পে ক্লিক করুন। টুলটি সম্পূর্ণ HTTP অনুরোধ এবং API থেকে লাইভ JSON প্রতিক্রিয়া প্রদর্শন করে।

মূল ফিচার

  • লাইভ এক্সিকিউশন: আপনার প্রোডাকশন বা টেস্ট অ্যাকাউন্টের জন্য রিয়েল-টাইম search ও mutate অপারেশন সম্পাদন করুন।
  • JSON পেলোড ফর্ম্যাটিং: অনুরোধের জন্য ইন্টার‍্যাক্টিভভাবে জটিল JSON অবজেক্ট তৈরি করুন, টুলটি প্রয়োজনীয় ফিল্ড এবং সঠিক স্কিমা স্ট্রাকচার হাইলাইট করে।
  • ফিল্ড মাস্ক: update_mask লজিক পরীক্ষা করে দেখুন যে আংশিক রিসোর্স আপডেট বাস্তবে কীভাবে কাজ করে।
  • সমস্যা সংক্রান্ত তথ্য: দ্রুত ডিবাগিংয়ের জন্য র' রেসপন্সে বিস্তারিত সমস্যার মেসেজ ও কোড (যেমন QUERY_ERROR বা AUTHENTICATION_ERROR) দেখুন।
  • কোড এক্সপোর্ট: API এক্সপ্লোরারের বড় করা ভিউ থেকে curl কমান্ড, র HTTP অনুরোধ বা স্যাম্পেল JavaScript কোড এক্সপোর্ট করুন।

ব্যবহারের উদাহরণ

  • অ্যাকাউন্ট সেটিংস অডিট করা: customer রিসোর্সের বিরুদ্ধে GoogleAdsService/Search অনুরোধ কার্যকর করে অ্যাকাউন্ট-লেভেল কনফিগারেশন বা মেটাডেটা দ্রুত ফিরিয়ে আনা।
  • মিউটেশন টেস্ট করা: প্রোডাকশনে কোড ডেপ্লয় করার আগে ক্যাম্পেন তৈরি বা বাজেট আপডেট সফল হয়েছে কিনা তা যাচাই করুন।
  • GAQL ডিবাগ করা: Google Ads Query Language (GAQL) স্ট্রিং রান করতে এক্সপ্লোরার ব্যবহার করুন এবং যাচাই করুন যে রিটার্ন করা JSON স্ট্রাকচার আপনার অ্যাপ্লিকেশনের প্রত্যাশার সাথে মেলে।
  • প্রোটোকল যাচাইকরণ: নির্দিষ্ট API ভার্সনের জন্য প্রয়োজনীয় সঠিক HTTP হেডার ও JSON নেস্টিং পরীক্ষা করে দেখুন।