নামের হায়ারার্কি
Google Ads API-তে ব্যবহৃত রিসোর্স নামগুলি হায়ারার্কিক্যাল, যা Google Ads-এর মধ্যে
এন্টিটির সংগঠনকে মিরর করে। প্রায় সব রিসোর্সই Customer
রিসোর্সের
সাব-রিসোর্স, যা এই বিষয়টিই তুলে ধরে যে প্রায় প্রতিটি API কলকেই একটি
নির্দিষ্ট Google Ads অ্যাকাউন্টকে টার্গেট করতে হয়। যেমন, ক্যাম্পেন, বিজ্ঞাপন গ্রুপ, বিজ্ঞাপন এবং কীওয়ার্ড
সবই হল রুট গ্রাহক রিসোর্সের সাব-রিসোর্স।
| রিসোর্স | রিসোর্সের নাম |
|---|---|
| গ্রাহক | customers/1234567890
|
| ক্যাম্পেন | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
রিসোর্স আইডি
API জুড়ে Google Ads এন্টিটি (গ্রাহক, ক্যাম্পেন ইত্যাদি) তাদের রিসোর্স নাম দিয়ে উল্লেখ করা হয়। তবে, এটি মনে রাখা গুরুত্বপূর্ণ যে রিসোর্স নামের নিজস্ব অনন্য সংখ্যাসূচক রিসোর্স আইডি থাকতে পারে যা হায়ারার্কিতে প্রতিটি অবজেক্ট শনাক্ত করে। এইসব ক্ষেত্রে, রিসোর্স আইডি এক্সট্র্যাক্ট করতে এবং নতুন একটি অ্যাসেম্বল করতে রিসোর্সের নাম পার্স করা উপযোগী হতে পারে।
যেমন, আগের টেবিল থেকে AdGroupAd রিসোর্স নাম পরীক্ষা করুন:
customers/1234567890/adGroupAds/54321098765~2109876543210
এটি আলাদা আলাদা রিসোর্স আইডিতে (যা সংগ্রহ আইডি দিয়ে আলাদা করা হয়) ভাগ করা যায়, যেমন:
| রিসোর্সের নামের কম্পোনেন্ট | |||||||
|---|---|---|---|---|---|---|---|
| রিসোর্স আইডি |
|
||||||
| কালেকশন আইডি |
|
||||||
আলাদা আলাদা আইডি পার্স করার মাধ্যমে আপনি বিজ্ঞাপন গ্রুপের বিজ্ঞাপনের গ্রাহক (customers/1234567890) বা তার বিজ্ঞাপন গ্রুপ (customers/1234567890/adGroupAds/54321098765) রেফারেন্স করার জন্য নতুন রিসোর্স নাম পেতে পারেন।
শেয়ার করা অবজেক্টের শনাক্তকারী
API-এর বেশিরভাগ অবজেক্ট একটি নির্দিষ্ট Google Ads গ্রাহকের সাথে যুক্ত থাকে। তবে, কিছু অবজেক্টের ধরন আছে যা একাধিক অ্যাকাউন্টের মধ্যে শেয়ার করা যেতে পারে। বাস্তবে, এগুলি হল নেগেটিভ কীওয়ার্ডের তালিকা বা ক্রস-অ্যাকাউন্ট কনভার্সন অ্যাকশন যা সাধারণত ম্যানেজাররা তৈরি করেন এবং তারপরে একাধিক ক্লায়েন্ট অ্যাকাউন্টের সাথে শেয়ার করেন।
এই ধরনের অবজেক্টের রিসোর্স নাম আলাদা হবে, আপনি কোন অ্যাকাউন্টে API কল পাঠাচ্ছেন তার উপর নির্ভর করে।
যেমন: বিভিন্ন অ্যাকাউন্ট জুড়ে হওয়া কনভার্সন অ্যাকশন
ধরা যাক, আমাদের কাছে ম্যানেজার অ্যাকাউন্ট 987-654-3210 আছে যা তার একটি ক্লায়েন্ট গ্রাহক অ্যাকাউন্ট 123-456-7890-এর সাথে ক্রস-অ্যাকাউন্ট
কনভার্সন অ্যাকশন শেয়ার করে:
ম্যানেজার অ্যাকাউন্টে API কল করে, যেমন, কনভার্সন
অ্যাকশনের লুকব্যাক উইন্ডো আপডেট করার জন্য, রিসোর্স নাম ব্যবহার করে শেয়ার করা অবজেক্টকে রেফার করা হবে:
customers/9876543210/conversionActions/257733534।
শেয়ার করা কনভার্সন অ্যাকশন ব্যবহার করার জন্য অপ্ট-ইন করতে ক্লায়েন্ট অ্যাকাউন্টে API কল করলে, রিসোর্স নাম ব্যবহার করে এটি রেফার করা হবে:
customers/1234567890/conversionActions/257733534।
এটি একই অন্তর্নিহিত কনভার্সন অ্যাকশন, তবে এর রিসোর্স নাম এটি অ্যাক্সেস করার জন্য ব্যবহৃত অ্যাকাউন্টের সাথে সম্পর্কিত।