API স্ট্রাকচার গাইডে যেমন আলোচনা করা হয়েছে, Google Ads API-এর প্রতিটি টপ-লেভেল রিসোর্সে একটি সংশ্লিষ্ট রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবা রয়েছে যা সমর্থন করে:
- সম্পদের উদাহরণ পরিবর্তন করা হচ্ছে
- পরিদর্শনের জন্য সম্পদের একটি একক উদাহরণ পুনরুদ্ধার করা হচ্ছে
এই নির্দেশিকা Campaign বস্তুর পরিবর্তন ও পরিদর্শন প্রদর্শনের জন্য CampaignService ব্যবহার করবে, কিন্তু একই ধারণা অন্যান্য সমস্ত রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবার ক্ষেত্রে প্রযোজ্য।
বস্তু পরিবর্তন
প্রতিটি রিসোর্স-টাইপ-নির্দিষ্ট পরিষেবার একটি মিউটেট পদ্ধতি থাকবে যা একটি মিউটেট অনুরোধ গ্রহণ করে। এই অনুরোধের মধ্যে রয়েছে:
- একটি
customerId - অপারেশন একটি সংগ্রহ
- একটি প্রতিক্রিয়া বিষয়বস্তুর প্রকারের সেটিং যা নির্ধারণ করে যে পরিবর্তনযোগ্য সংস্থান বা কেবলমাত্র সম্পদের নাম মিউটেশনের পরে ফেরত দেওয়া উচিত কিনা।
উদাহরণস্বরূপ, CampaignService এর MutateCampaigns পদ্ধতি একটি MutateCampaignsRequest গ্রহণ করে যার মধ্যে রয়েছে:
- একটি
customerId -
CampaignOperationঅবজেক্টের একটি সংগ্রহ -
response_content_typeক্ষেত্রটি পছন্দের প্রতিক্রিয়া প্রকার নির্দেশ করে।
অপারেশন
একটি অপারেশন অবজেক্ট যেমন একটি CampaignOperation আপনাকে এটির operation ক্ষেত্র সেট করে একটি একক সংস্থানে যে ক্রিয়াটি সম্পাদন করতে চান তা নির্দিষ্ট করতে দেয়। এই ক্ষেত্রটি নিম্নোক্ত গুণাবলী নিয়ে গঠিত একটি ক্ষেত্র যার ধরন হল রিসোর্স টাইপ:
-
create - সম্পদের একটি নতুন উদাহরণ তৈরি করে।
-
update -
updateরিসোর্সের অ্যাট্রিবিউটের সাথে মেলে রিসোর্স আপডেট করে। যখন এই ক্ষেত্রটি সেট করা হয়, তখন আপনাকে অবশ্যই অপারেশনেরupdate_maskসেট করতে হবে, যা Google Ads API-কে বলে যে আপডেট অপারেশন চলাকালীন পরিবর্তন করতে হবে। প্রতিটি ক্লায়েন্ট লাইব্রেরির একটি ইউটিলিটি বা সহায়ক পদ্ধতি রয়েছে যা আপনার জন্যupdate_maskতৈরি করবে, যেমনটি আমাদের ক্লায়েন্ট লাইব্রেরিতে দেখানো হয়েছে। -
remove - সম্পদ সরিয়ে দেয়।
যেহেতু operation ক্ষেত্রটি একটি ক্ষেত্রের oneof , আপনি একাধিক বস্তু পরিবর্তন করতে একটি একক অপারেশন ব্যবহার করতে পারবেন না। উদাহরণস্বরূপ, যদি আপনি একটি প্রচার তৈরি করতে চান এবং অন্য প্রচারাভিযান সরাতে চান, তাহলে আপনার অনুরোধে CampaignOperation দুটি উদাহরণ যোগ করুন: একটি create সেট সহ, এবং অন্যটি remove সেট সহ।
ব্যাচিং অপারেশন
যদিও একটি একক ক্রিয়াকলাপ শুধুমাত্র একটি একক সংস্থান তৈরি, আপডেট বা অপসারণ করতে পারে, একটি একক মিউটেট অনুরোধে একাধিক অপারেশন থাকতে পারে। একাধিক মিউটেট অনুরোধ পাঠানোর পরিবর্তে আপনার ক্রিয়াকলাপগুলিকে একটি একক মিউটেট অনুরোধে একত্রিত করা উচিত যাতে প্রতিটিতে একটি একক অপারেশন থাকে।
উদাহরণস্বরূপ, আপনি যদি দশটি প্রচারাভিযান তৈরি করতে চান, তাহলে আপনাকে একটি একক MutateCampaignsRequest পাঠাতে হবে যাতে দশটি CampaignOperation অবজেক্ট রয়েছে।
মিউটেট প্রতিক্রিয়া
প্রতিক্রিয়াতে কী ফেরত দেওয়া হয় তা নির্ভর করে মিউটেট অনুরোধের response_content_type কী পাঠানো হয়েছিল তার উপর। উদাহরণস্বরূপ, যদি MUTABLE_RESOURCE নির্দিষ্ট করা হয়, তাহলে প্রতিক্রিয়াতে প্রচারাভিযানের পরিবর্তনযোগ্য ক্ষেত্র থাকবে। তারপরে আপনি এটিকে পুনর্গঠন না করেই সেই রিসোর্স অবজেক্টে ফলো-আপ মিউটেট করতে পারেন।
মিউটেট ত্রুটি
একটি প্রদত্ত মিউটেট অনুরোধের অপারেশনগুলি শুধুমাত্র আপনার Google বিজ্ঞাপন অ্যাকাউন্টে প্রয়োগ করা হবে যদি অনুরোধের প্রতিটি অপারেশন সফল হয়। সাধারণ ত্রুটিগুলির একটি তালিকা এবং কীভাবে সেগুলিকে সমাধান করতে হয় তার জন্য সাধারণ ত্রুটি নির্দেশিকাটি দেখুন৷