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

উদ্দেশ্য: Google Ads API ব্যবহার করে কীভাবে বস্তু পরিবর্তন করতে হয় তা বুঝুন।

API স্ট্রাকচার গাইডে আলোচনা করা হয়েছে, Google Ads API-এর প্রতিটি শীর্ষ-স্তরের রিসোর্সের একটি সংশ্লিষ্ট রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবা রয়েছে যা রিসোর্সের উদাহরণ পরিবর্তন করতে সহায়তা করে।

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

মূল শব্দ: একটি শীর্ষ-স্তরের সম্পদ হল এমন একটি সম্পদ যার নামে একটি সময়কাল ( . ) অন্তর্ভুক্ত থাকে না। উদাহরণস্বরূপ, Campaign একটি শীর্ষ-স্তরের সম্পদ, কিন্তু Campaign.NetworkSettings নয়।

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

প্রতিটি রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবার একটি mutate পদ্ধতি থাকবে যা একটি mutate অনুরোধ গ্রহণ করে। এই অনুরোধে রয়েছে:

• একটি 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 set সহ, এবং অন্যটি remove set সহ।

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

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

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

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

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

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

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

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

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

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

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