অবজেক্ট পরিবর্তন করুন

এপিআই কাঠামো নির্দেশিকায় যেমন আলোচনা করা হয়েছে, গুগল অ্যাডস এপিআই-এর প্রতিটি শীর্ষ-স্তরের রিসোর্সের একটি সংশ্লিষ্ট রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবা রয়েছে যা রিসোর্সটির ইনস্ট্যান্স পরিবর্তন করতে সহায়তা করে।

এই নির্দেশিকায় Campaign অবজেক্ট পরিবর্তন করার পদ্ধতি দেখানোর জন্য CampaignService ব্যবহার করা হবে, কিন্তু একই ধারণা অন্যান্য সকল রিসোর্স-টাইপ-নির্দিষ্ট সার্ভিসের ক্ষেত্রেও প্রযোজ্য।

বস্তু পরিবর্তন করুন

প্রতিটি রিসোর্স-টাইপ-নির্দিষ্ট সার্ভিসের একটি মিউটেট মেথড থাকবে যা একটি মিউটেট রিকোয়েস্ট গ্রহণ করবে। এই রিকোয়েস্টটিতে নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত থাকে:

• একজন customerId
• ক্রিয়াকলাপের একটি সংগ্রহ
• একটি রেসপন্স কন্টেন্ট-টাইপ সেটিং যা নির্ধারণ করে যে মিউটেশনের পরে পরিবর্তনযোগ্য রিসোর্সটি নাকি শুধু রিসোর্সের নামটি ফেরত দেওয়া হবে।

উদাহরণস্বরূপ, CampaignService এর MutateCampaigns মেথডটি একটি MutateCampaignsRequest গ্রহণ করে, যা নিম্নলিখিত বিষয়গুলো নিয়ে গঠিত:

• একজন customerId
• CampaignOperation অবজেক্টের একটি সংগ্রহ
• response_content_type ফিল্ডটি পছন্দের প্রতিক্রিয়ার ধরণ নির্দেশ করে।

অপারেশন

CampaignOperation এর মতো একটি অপারেশন অবজেক্ট আপনাকে এর operation ফিল্ড সেট করার মাধ্যমে একটি একক রিসোর্সের উপর যে কাজটি সম্পাদন করতে চান তা নির্দিষ্ট করার সুযোগ দেয়। এই ফিল্ডটি একটি 'oneof' ফিল্ড, যা নিম্নলিখিত অ্যাট্রিবিউটগুলো নিয়ে গঠিত এবং যার টাইপ হলো রিসোর্স টাইপ:

create

রিসোর্সটির একটি নতুন ইনস্ট্যান্স তৈরি করে।

update

update অ্যাট্রিবিউটগুলোর সাথে মেলানোর জন্য রিসোর্সটিকে আপডেট করে।

রিসোর্স। যখন এই ফিল্ডটি সেট করা হয়, তখন আপনাকে অবশ্যই অপারেশনটির update_mask ও সেট করতে হবে, যা Google Ads API-কে বলে দেয় যে আপডেট অপারেশনের সময় কোন অ্যাট্রিবিউটগুলো পরিবর্তন করতে হবে। প্রতিটি ক্লায়েন্ট লাইব্রেরিতে একটি ইউটিলিটি বা হেল্পার মেথড রয়েছে যা আপনার জন্য update_mask তৈরি করে দেবে, যেমনটি আমাদের ক্লায়েন্ট লাইব্রেরিগুলোতে দেখানো হয়েছে।

remove

রিসোর্সটি মুছে ফেলে।

যেহেতু operation ফিল্ডটি একটি oneof ফিল্ড, তাই আপনি একাধিক অবজেক্ট পরিবর্তন করার জন্য একটিমাত্র অপারেশন ব্যবহার করতে পারবেন না। উদাহরণস্বরূপ, যদি আপনি একটি ক্যাম্পেইন তৈরি করতে এবং অন্য একটি ক্যাম্পেইন মুছে ফেলতে চান, তাহলে আপনার রিকোয়েস্টে CampaignOperation এর দুটি ইনস্ট্যান্স যোগ করুন: একটিতে create ' সেট করুন এবং অন্যটিতে remove ' সেট করুন।

ব্যাচ অপারেশন

যদিও একটি একক অপারেশন শুধুমাত্র একটি রিসোর্স তৈরি, আপডেট বা অপসারণ করতে পারে, একটি একক মিউটেট রিকোয়েস্টে একাধিক অপারেশন থাকতে পারে। প্রতিটি একক অপারেশন সম্বলিত একাধিক মিউটেট রিকোয়েস্ট পাঠানোর পরিবর্তে, আপনার অপারেশনগুলোকে একটি একক মিউটেট রিকোয়েস্টে একত্রিত করা উচিত।

উদাহরণস্বরূপ, যদি আপনি দশটি ক্যাম্পেইন তৈরি করতে চান, তাহলে আপনাকে একটিমাত্র MutateCampaignsRequest পাঠাতে হবে, যেটিতে দশটি CampaignOperation অবজেক্ট থাকবে।

পরিবর্তিত প্রতিক্রিয়া

মিউটেট রিকোয়েস্টের response_content_type এ কী পাঠানো হয়েছিল, তার উপর নির্ভর করে রেসপন্সে কী ফেরত আসবে। উদাহরণস্বরূপ, যদি MUTABLE_RESOURCE নির্দিষ্ট করা থাকে, তাহলে রেসপন্সে ক্যাম্পেইনের শুধু পরিবর্তনযোগ্য ফিল্ডগুলোই থাকবে। এরপর আপনি সেই রিসোর্স অবজেক্টটিকে পুনর্গঠন না করেই সেটির উপর পরবর্তী মিউটেটগুলো করতে পারবেন।

মিউটেট ত্রুটি

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

পরিবর্তনগুলি ট্র্যাক করুন

আপনার গুগল অ্যাডস অ্যাকাউন্টের অবজেক্টগুলিতে করা পরিবর্তনগুলি ট্র্যাক করতে, বা অবজেক্টগুলির বর্তমান অবস্থা জানতে, আপনি change_status এবং change_event রিসোর্সগুলি ব্যবহার করতে পারেন।

• change_status একটি নির্দিষ্ট সময়কালের মধ্যে কোন কোন রিসোর্সের পরিবর্তন হয়েছে তার একটি সারসংক্ষেপ প্রদান করে।
• change_event পরিবর্তনগুলোর একটি বিশদ ইতিহাস প্রদান করে, যার মধ্যে পরিবর্তিত ফিল্ডগুলোর পুরোনো এবং নতুন মান অন্তর্ভুক্ত থাকে।

এই রিসোর্সগুলো কোয়েরি করতে, GoogleAdsService.SearchStream অথবা GoogleAdsService.Search মেথড ব্যবহার করুন। GoogleAdsService ব্যবহার করে রিপোর্ট স্ট্রিমিং সম্পর্কে আরও পড়ুন।