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

আপনার ব্যবহারের উপর নির্ভর করে Google Ads API রিসোর্স মিউটেট করার একাধিক উপায় প্রদান করে কেস:

  • রিসোর্স সার্ভিস মিউটেট: প্রতিটি মিউটেবল রিসোর্সের একটি ডেডিকেটেড সার্ভিস থাকে যা সেই নির্দিষ্ট রিসোর্স টাইপের জন্য অপারেশন এক্সিকিউট করে। যেমন, Campaign রিসোর্স ক্যাম্পেন তৈরি, আপডেট বা সরানোর জন্য CampaignService.MutateCampaigns এন্ডপয়েন্ট ব্যবহার করে।
  • বাল্ক মিউটেট: GoogleAdsService.Mutate এন্ডপয়েন্ট একাধিক রিসোর্স টাইপ (এবং বুকিং বা কোটেশন ক্যাম্পেনের মতো কাজ) জুড়ে মিউটেট অপারেশনের একটি ক্রমকে একটি সিঙ্ক্রোনাস অনুরোধে র‌্যাপ করে।
  • অ্যাসিঙ্ক্রোনাস ব্যাচ জব: বড় মাপের মিউটেশন বা দীর্ঘ সময় ধরে চলা ওয়ার্কলোডের জন্য, BatchJobService সিঙ্ক্রোনাস অনুরোধ টাইমআউটের ঝুঁকি ছাড়াই অ্যাসিঙ্ক্রোনাসভাবে অপারেশন এক্সিকিউট করে। GoogleAdsService.Mutate-এর মতো নয়, BatchJobService সবসময় আংশিক-ব্যর্থতা সিম্যান্টিক্সের অধীনে এক্সিকিউট করে এবং validate_only মোড বা অ্যাকশন অপারেশন (book_campaigns_operation, quote_campaigns_operation) সমর্থন করে না। যেহেতু আংশিক ব্যর্থতা সবসময় অ্যাক্টিভ থাকে, BatchJobService সেইসব রিসোর্স অপারেশন বাতিল করে দেয় যেগুলির অন্তর্নিহিত পরিষেবা আংশিক ব্যর্থতা (যেমন CustomerOperation, CampaignConversionGoalOperation, ConversionGoalCampaignConfigOperation, CustomConversionGoalOperation, এবং CustomerConversionGoalOperation) সমর্থন করে না, MutateError.OPERATION_DOES_NOT_SUPPORT_PARTIAL_FAILURE সহ।

বাল্ক মিউটেটের সুবিধা

GoogleAdsService.Mutate ব্যবহার করলে নিম্নলিখিত সুবিধা পাওয়া যায় (প্রয়োগ সংক্রান্ত নির্দেশিকার জন্য Mutate সংক্রান্ত পেশাদার পদ্ধতি দেখুন):

  • বিভিন্ন রিসোর্স পরিষেবা জুড়ে গ্রুপ করা অ্যাকশন: যেখানে স্বতন্ত্র রিসোর্স পরিষেবা কল শুধুমাত্র একটি রিসোর্স প্রকারের জন্য অপারেশন গ্রহণ করে, GoogleAdsService.Mutate আপনাকে একটি কলে একাধিক রিসোর্স প্রকার মিউটেট করতে দেয়।
  • টেম্পোরারি রিসোর্সের নাম: আপনি নতুন তৈরি করা পেরেন্ট এন্টিটিতে নেগেটিভ ইন্টিজার আইডি (যেমন customers/CUSTOMER_ID/campaigns/-1) অ্যাসাইন করতে পারেন এবং একই অনুরোধের মধ্যে চাইল্ড অপারেশনে সেই টেম্পোরারি আইডি রেফারেন্স করতে পারেন।

এইসব ক্ষমতার সাহায্যে, আপনি GoogleAdsService.Mutate ব্যবহার করে একটি সম্পূর্ণ ক্যাম্পেন হায়ারার্কি অ্যাটমিক্যালি তৈরি করতে পারেন যাতে সমস্ত অপারেশন একসাথে সফল বা ব্যর্থ হয়, অথবা স্বাধীনভাবে বৈধ অপারেশনগুলি কমিট করতে partial_failure-কে true-এ সেট করতে পারেন।

পরবর্তী
রিসোর্স মিউটেশন