এপিআই স্ট্রাকচার

ভিডিও: 2019 কর্মশালা থেকে পরিষেবা এবং সম্পদের আলোচনা দেখুন

এই গাইডটি প্রাথমিক উপাদানগুলির সাথে পরিচয় করিয়ে দেয় যা Google Ads API তৈরি করে। Google বিজ্ঞাপন এপিআই সম্পদ এবং পরিষেবা নিয়ে গঠিত। একটি সংস্থান একটি Google বিজ্ঞাপন সত্তাকে প্রতিনিধিত্ব করে, যখন পরিষেবাগুলি পুনরুদ্ধার করে এবং Google বিজ্ঞাপন সংস্থাগুলিকে ম্যানিপুলেট করে৷

অবজেক্ট অনুক্রম

একটি Google বিজ্ঞাপন অ্যাকাউন্টকে অবজেক্টের অনুক্রম হিসাবে দেখা যেতে পারে।

প্রচারের মডেল

  • একটি অ্যাকাউন্টের শীর্ষ-স্তরের সংস্থান হল গ্রাহক

  • প্রতিটি গ্রাহকের এক বা একাধিক সক্রিয় প্রচারাভিযান রয়েছে।

  • প্রতিটি প্রচারাভিযানে এক বা একাধিক বিজ্ঞাপন গোষ্ঠী থাকে, যা আপনার বিজ্ঞাপনগুলিকে যৌক্তিক সংগ্রহে গোষ্ঠীবদ্ধ করতে ব্যবহৃত হয়।

  • একটি বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন এমন একটি বিজ্ঞাপনকে উপস্থাপন করে যা আপনি চালাচ্ছেন। অ্যাপ প্রচারাভিযান ব্যতীত যেখানে প্রতি বিজ্ঞাপন গোষ্ঠীতে শুধুমাত্র একটি বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন থাকতে পারে, প্রতিটি বিজ্ঞাপন গোষ্ঠীতে এক বা একাধিক বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন থাকে।

আপনি একটি বিজ্ঞাপন গ্রুপ বা প্রচারাভিযানে এক বা একাধিক AdGroupCriterion বা CampaignCriterion সংযুক্ত করতে পারেন। এগুলি এমন মাপদণ্ডের প্রতিনিধিত্ব করে যা সংজ্ঞায়িত করে যে কীভাবে বিজ্ঞাপনগুলি ট্রিগার হয়৷

অনেক মানদণ্ডের ধরন আছে, যেমন কীওয়ার্ড, বয়সের সীমা এবং অবস্থান। প্রচারাভিযানের স্তরে সংজ্ঞায়িত মানদণ্ড প্রচারাভিযানের মধ্যে অন্যান্য সমস্ত সংস্থানকে প্রভাবিত করে। এছাড়াও আপনি প্রচারাভিযান-ব্যাপী বাজেট এবং তারিখ নির্দিষ্ট করতে পারেন।

অবশেষে, আপনি অ্যাকাউন্ট, প্রচারাভিযান বা বিজ্ঞাপন গোষ্ঠী স্তরে এক্সটেনশন সংযুক্ত করতে পারেন। এক্সটেনশনগুলি আপনাকে আপনার বিজ্ঞাপনগুলিতে অতিরিক্ত তথ্য প্রদান করতে দেয়, যেমন ফোন নম্বর, রাস্তার ঠিকানা, বা প্রচার৷

সম্পদ

সম্পদগুলি আপনার Google বিজ্ঞাপন অ্যাকাউন্টের মধ্যে থাকা সত্তাগুলিকে প্রতিনিধিত্ব করে। Campaign এবং AdGroup সম্পদের দুটি উদাহরণ।

অবজেক্ট আইডি

Google Ads-এর প্রতিটি বস্তুর নিজস্ব আইডি দ্বারা চিহ্নিত করা হয়। এই আইডিগুলির মধ্যে কিছু সমস্ত Google বিজ্ঞাপন অ্যাকাউন্ট জুড়ে বিশ্বব্যাপী অনন্য, অন্যগুলি শুধুমাত্র একটি সীমিত পরিধির মধ্যে অনন্য।

অবজেক্ট আইডি অনন্যতার সুযোগ বিশ্বব্যাপী অনন্য?
বাজেট আইডি গ্লোবাল হ্যাঁ
ক্যাম্পেইন আইডি গ্লোবাল হ্যাঁ
অ্যাডগ্রুপ আইডি গ্লোবাল হ্যাঁ
বিজ্ঞাপন আইডি বিজ্ঞাপন গ্রুপ না, কিন্তু ( AdGroupId , AdId ) জোড়া বিশ্বব্যাপী অনন্য
AdGroupCriterion ID বিজ্ঞাপন গ্রুপ না, কিন্তু ( AdGroupId , CriterionId ) জোড়া বিশ্বব্যাপী অনন্য
প্রচারণার মানদণ্ড আইডি প্রচারণা না, কিন্তু ( CampaignId , CriterionId ) জোড়া বিশ্বব্যাপী অনন্য
বিজ্ঞাপন এক্সটেনশন প্রচারণা না, কিন্তু ( CampaignId , AdExtensionId ) জোড়া বিশ্বব্যাপী অনন্য
ফিড আইডি গ্লোবাল হ্যাঁ
ফিড আইটেম আইডি গ্লোবাল হ্যাঁ
ফিড অ্যাট্রিবিউট আইডি খাওয়ান না
ফিড ম্যাপিং আইডি গ্লোবাল হ্যাঁ
লেবেল আইডি গ্লোবাল হ্যাঁ
ব্যবহারকারী তালিকা আইডি গ্লোবাল হ্যাঁ

আপনার Google বিজ্ঞাপন অবজেক্টের জন্য স্থানীয় স্টোরেজ ডিজাইন করার সময় এই আইডি নিয়মগুলি কার্যকর হতে পারে।

কিছু বস্তু একাধিক সত্তা ধরনের জন্য ব্যবহার করা যেতে পারে. এই ধরনের ক্ষেত্রে, বস্তুতে একটি type ক্ষেত্র থাকে যা এর বিষয়বস্তু বর্ণনা করে। উদাহরণস্বরূপ, AdGroupAd একটি বস্তুর উল্লেখ করতে পারে যেমন একটি পাঠ্য বিজ্ঞাপন, হোটেল বিজ্ঞাপন, বা স্থানীয় বিজ্ঞাপন। এই মানটি AdGroupAd.ad.type ক্ষেত্রের মাধ্যমে অ্যাক্সেস করা যেতে পারে এবং AdType enum-এ একটি মান প্রদান করে।

সম্পদের নাম

প্রতিটি সংস্থান একটি resource_name স্ট্রিং দ্বারা স্বতন্ত্রভাবে চিহ্নিত করা হয়, যা সম্পদ এবং এর পিতামাতাকে একটি পথের মধ্যে সংযুক্ত করে। উদাহরণস্বরূপ, প্রচারাভিযান সংস্থান নামের ফর্ম রয়েছে:

customers/customer_id/campaigns/campaign_id

তাই গ্রাহক আইডি 1234567 সহ Google Ads অ্যাকাউন্টে আইডি 987654 সহ একটি প্রচারের জন্য, resource_name হবে:

customers/1234567/campaigns/987654

সেবা

পরিষেবাগুলি আপনাকে আপনার Google বিজ্ঞাপন সত্তাগুলি পুনরুদ্ধার এবং সংশোধন করতে দেয়৷ তিন ধরনের পরিষেবা রয়েছে: পরিবর্তন, অবজেক্ট এবং স্ট্যাট পুনরুদ্ধার এবং মেটাডেটা পুনরুদ্ধার পরিষেবা।

বস্তু পরিবর্তন (মিউটেট)

এই পরিষেবাগুলি একটি mutate অনুরোধ ব্যবহার করে সংশ্লিষ্ট রিসোর্স প্রকারের উদাহরণগুলিকে সংশোধন করে৷ তারা একটি get অনুরোধও সরবরাহ করে যা একটি একক সংস্থান উদাহরণ পুনরুদ্ধার করে, যা একটি সংস্থানের কাঠামো পরীক্ষা করার জন্য কার্যকর হতে পারে।

পরিষেবার উদাহরণ:

প্রতিটি mutate অনুরোধে সংশ্লিষ্ট operation অবজেক্টগুলি অন্তর্ভুক্ত করতে হবে। উদাহরণস্বরূপ, CampaignService.MutateCampaigns পদ্ধতি CampaignOperation এর এক বা একাধিক উদাহরণ আশা করে। ক্রিয়াকলাপের বিস্তারিত আলোচনার জন্য বস্তুর পরিবর্তন এবং পরিদর্শন দেখুন।

সমবর্তী মিউটেট

একটি Google বিজ্ঞাপন অবজেক্ট একাধিক উত্স দ্বারা একযোগে সংশোধন করা যাবে না। আপনি যদি একাধিক ব্যবহারকারী আপনার অ্যাপের সাথে একই অবজেক্ট আপডেট করেন বা আপনি একাধিক থ্রেড ব্যবহার করে সমান্তরালভাবে Google বিজ্ঞাপন অবজেক্টগুলিকে পরিবর্তন করে থাকেন তাহলে এটি ত্রুটির কারণ হতে পারে। এর মধ্যে একই অ্যাপ্লিকেশানের একাধিক থ্রেড বা বিভিন্ন অ্যাপ্লিকেশান থেকে (উদাহরণস্বরূপ, আপনার অ্যাপ এবং একই সাথে Google বিজ্ঞাপন UI সেশন) থেকে অবজেক্ট আপডেট করা অন্তর্ভুক্ত।

API আপডেট করার আগে একটি বস্তু লক করার একটি উপায় প্রদান করে না; যদি দুটি উত্স একই সাথে একটি বস্তুকে পরিবর্তন করার চেষ্টা করে, API একটি DatabaseError.CONCURRENT_MODIFICATION_ERROR উত্থাপন করে।

অ্যাসিঙ্ক্রোনাস বনাম সিঙ্ক্রোনাস মিউটেটস

Google Ads API মিউটেট পদ্ধতিগুলি সিঙ্ক্রোনাস। এপিআই কলগুলি অবজেক্টগুলি পরিবর্তিত হওয়ার পরেই একটি প্রতিক্রিয়া প্রদান করে, আপনাকে প্রতিটি অনুরোধের প্রতিক্রিয়ার জন্য অপেক্ষা করতে হবে। যদিও এই পদ্ধতিটি কোডের জন্য তুলনামূলকভাবে সহজবোধ্য, এটি লোড ব্যালেন্সিং এবং বর্জ্য সংস্থানগুলিকে নেতিবাচকভাবে প্রভাবিত করতে পারে যদি প্রক্রিয়াগুলি কল সম্পূর্ণ হওয়ার জন্য অপেক্ষা করতে বাধ্য হয়।

একটি বিকল্প পদ্ধতি হল BatchJobService ব্যবহার করে অসিঙ্ক্রোনাসভাবে বস্তুগুলিকে পরিবর্তন করা, যা তাদের সমাপ্তির জন্য অপেক্ষা না করে একাধিক পরিষেবাতে ব্যাচের অপারেশনগুলি সম্পাদন করে। একবার একটি ব্যাচ জব জমা দেওয়া হলে, Google Ads API সার্ভারগুলি অ্যাসিঙ্ক্রোনাসভাবে ক্রিয়াকলাপগুলি সম্পাদন করে, অন্যান্য ক্রিয়াকলাপগুলি সম্পাদন করার প্রক্রিয়াগুলিকে মুক্ত করে৷ আপনি পর্যায়ক্রমে সমাপ্তির জন্য কাজের স্থিতি পরীক্ষা করতে পারেন।

অ্যাসিঙ্ক্রোনাস প্রসেসিং সম্পর্কে আরও জানতে ব্যাচ প্রসেসিং গাইড দেখুন।

মিউটেটের বৈধতা

বাস্তবিক ডেটার বিপরীতে কলটি কার্যকর না করেই বেশিরভাগ মিউটেট অনুরোধ যাচাই করা যেতে পারে। আপনি অনুপস্থিত পরামিতি এবং ভুল ক্ষেত্রের মানের জন্য অনুরোধটি আসলে অপারেশনটি নির্বাহ না করে পরীক্ষা করতে পারেন।

এই বৈশিষ্ট্যটি ব্যবহার করতে, অনুরোধের ঐচ্ছিক validate_only বুলিয়ান ক্ষেত্রটিকে true এ সেট করুন। অনুরোধটি তখন সম্পূর্ণরূপে বৈধ হবে যেন এটি কার্যকর হতে চলেছে, তবে চূড়ান্ত মৃত্যুদন্ড এড়িয়ে গেছে। যদি কোন ত্রুটি পাওয়া যায় না, একটি খালি প্রতিক্রিয়া ফেরত দেওয়া হয়। বৈধতা ব্যর্থ হলে, প্রতিক্রিয়ার ত্রুটি বার্তাগুলি ব্যর্থতার পয়েন্টগুলি নির্দেশ করবে।

validate_only সাধারণ নীতি লঙ্ঘনের জন্য বিজ্ঞাপন পরীক্ষা করার জন্য বিশেষভাবে উপযোগী। বিজ্ঞাপনগুলি স্বয়ংক্রিয়ভাবে প্রত্যাখ্যান করা হয় যদি সেগুলি নির্দিষ্ট শব্দ, বিরাম চিহ্ন, ক্যাপিটালাইজেশন বা দৈর্ঘ্যের মতো নীতি লঙ্ঘন করে। একটি খারাপ বিজ্ঞাপন একটি সম্পূর্ণ ব্যাচ ব্যর্থ হতে পারে. validate_only এর মধ্যে একটি নতুন বিজ্ঞাপন পরীক্ষা করলে এই ধরনের কোনো লঙ্ঘন প্রকাশ পেতে পারে। এটি কার্যকরভাবে দেখতে নীতি লঙ্ঘন ত্রুটিগুলি পরিচালনা করার জন্য কোড উদাহরণ পড়ুন৷

বস্তু এবং কর্মক্ষমতা পরিসংখ্যান পান

GoogleAdsService হল বস্তু এবং কর্মক্ষমতা পরিসংখ্যান পুনরুদ্ধারের জন্য একক, একীভূত পরিষেবা।

GoogleAdsService এর জন্য সমস্ত Search এবং SearchStream অনুরোধগুলির জন্য একটি ক্যোয়ারী প্রয়োজন যা কোয়েরির জন্য সংস্থান, পুনরুদ্ধারের জন্য সম্পদ বৈশিষ্ট্য এবং কর্মক্ষমতা মেট্রিক্স, অনুরোধটি ফিল্টার করার জন্য ব্যবহার করার পূর্বাভাস এবং কর্মক্ষমতা পরিসংখ্যানকে আরও ভাঙতে ব্যবহার করার জন্য সেগমেন্টগুলি নির্দিষ্ট করে৷ ক্যোয়ারী ফর্ম্যাট সম্পর্কে আরও তথ্যের জন্য, Google বিজ্ঞাপন কোয়েরি ভাষা নির্দেশিকা দেখুন।

মেটাডেটা পুনরুদ্ধার করুন

GoogleAdsFieldService Google Ads API-এর রিসোর্স সম্পর্কে মেটাডেটা পুনরুদ্ধার করে, যেমন একটি রিসোর্সের জন্য উপলব্ধ বৈশিষ্ট্য এবং তার ডেটা টাইপ।

এই পরিষেবাটি GoogleAdsService কে একটি প্রশ্ন তৈরি করার জন্য প্রয়োজনীয় তথ্য সরবরাহ করে। সুবিধার জন্য, GoogleAdsFieldService দ্বারা প্রত্যাবর্তিত তথ্য ক্ষেত্র রেফারেন্স ডকুমেন্টেশনেও উপলব্ধ।