সম্পদ তৈরি করে, আপডেট করে বা সরিয়ে দেয়। এই পদ্ধতি একাধিক ধরনের সম্পদের সাথে পারমাণবিক লেনদেন সমর্থন করে। উদাহরণস্বরূপ, আপনি পারমাণবিকভাবে একটি প্রচারাভিযান এবং একটি প্রচারাভিযানের বাজেট তৈরি করতে পারেন, অথবা পারমাণবিকভাবে হাজার হাজার পর্যন্ত মিউটেট করতে পারেন।
এই পদ্ধতিটি মূলত মিউটেট পদ্ধতির একটি সিরিজের চারপাশে একটি মোড়ক। শুধুমাত্র এই পদ্ধতিগুলিকে সরাসরি কল করার জন্য এটি অফার করে এমন বৈশিষ্ট্যগুলি হল:
- পারমাণবিক লেনদেন
- অস্থায়ী সম্পদের নাম (নীচে বর্ণিত)
- মিউটেট কলের একটি সিরিজ করার জন্য কিছুটা কম লেটেন্সি
দ্রষ্টব্য: শুধুমাত্র পারমাণবিক লেনদেন সমর্থনকারী সংস্থানগুলি অন্তর্ভুক্ত করা হয়েছে, তাই এই পদ্ধতিটি পৃথক পরিষেবাগুলিতে সমস্ত কল প্রতিস্থাপন করতে পারে না৷
পারমাণবিক লেনদেনের সুবিধা
পারমাণবিকতা ত্রুটি পরিচালনা অনেক সহজ করে তোলে। আপনি যদি একটি ধারাবাহিক পরিবর্তন করেন এবং একটি ব্যর্থ হয়, তাহলে এটি আপনার অ্যাকাউন্টটিকে একটি অসামঞ্জস্যপূর্ণ অবস্থায় রেখে যেতে পারে। পারমাণবিকতার সাথে, আপনি হয় সরাসরি নির্বাচিত অবস্থায় পৌঁছান, অথবা অনুরোধ ব্যর্থ হয় এবং আপনি আবার চেষ্টা করতে পারেন।
অস্থায়ী সম্পদের নাম
টেম্প রিসোর্স নাম হল একটি বিশেষ ধরনের রিসোর্স নাম যা একটি রিসোর্স তৈরি করতে ব্যবহৃত হয় এবং সেই রিসোর্সটিকে একই অনুরোধে উল্লেখ করা হয়। উদাহরণস্বরূপ, যদি customers/123/campaignBudgets/-1
এর সমান resourceName
দিয়ে একটি প্রচারাভিযানের বাজেট তৈরি করা হয়, সেই রিসোর্স নামটি একই অনুরোধে Campaign.budget
ক্ষেত্রে পুনরায় ব্যবহার করা যেতে পারে। এইভাবে, দুটি সংস্থান তৈরি এবং পারমাণবিকভাবে লিঙ্ক করা হয়।
একটি টেম্প রিসোর্স নাম তৈরি করতে, নামের অংশে একটি নেতিবাচক সংখ্যা রাখুন যা সার্ভার সাধারণত বরাদ্দ করে।
বিঃদ্রঃ:
- নামটি পুনরায় ব্যবহার করার আগে সম্পদগুলিকে একটি অস্থায়ী নাম দিয়ে তৈরি করতে হবে। উদাহরণ স্বরূপ, মিউটেট অর্ডারটি বিপরীত হলে পূর্ববর্তী CampaignBudget+Campaign উদাহরণ ব্যর্থ হবে।
- অনুরোধ জুড়ে অস্থায়ী নাম মনে রাখা হয় না।
- একটি অনুরোধে অস্থায়ী নামের সংখ্যার কোন সীমা নেই।
- প্রতিটি টেম্প নামের একটি অনন্য নেতিবাচক সংখ্যা ব্যবহার করা আবশ্যক, এমনকি যদি সম্পদের ধরন ভিন্ন হয়।
লেটেন্সি
রিসোর্স টাইপ অনুসারে মিউটেটগুলিকে গোষ্ঠীবদ্ধ করা গুরুত্বপূর্ণ নয়তো অনুরোধের সময় শেষ হয়ে ব্যর্থ হতে পারে। লেটেন্সি মোটামুটিভাবে পৃথক মিউটেট পদ্ধতিতে কলের একটি সিরিজের সমান, যেখানে রিসোর্সের প্রকারের প্রতিটি পরিবর্তন একটি নতুন কল। উদাহরণস্বরূপ, 10টি প্রচারাভিযান মিউট করা হলে 10টি বিজ্ঞাপন গোষ্ঠী 2টি কলের মতো, যখন 1টি প্রচারাভিযান, 1টি বিজ্ঞাপন গোষ্ঠী, 1টি প্রচারাভিযান, 1টি বিজ্ঞাপন গোষ্ঠীটি 4টি কলের মতো।
নিক্ষিপ্ত ত্রুটির তালিকা: AdCustomizerError AdGroupAdError AdGroupAdError AdGroupCriterionError AdGroupError AssetError AuthenticationError AuthorizationError Bidding Error CampaignBudgetError CampaignCriterionError CampaignErrorError Campigna ectionSizeError ContextError ConversionActionError CriterionError CustomerFeedError DatabaseError DateError DateRangeError DistinctError ExtensionFeedItemError ExtensionSettingError FeedAttributeReference Error FeedError FiedError FiedError dMaskError FunctionParsingError HeaderError Image Error Internal Error KeywordPlanAdGroupKeywordError KeywordPlanCampaignError KeywordPlanError LabelError ListOperationError MediaUploadError MutateErrorErrorNewRecessorirrorreed পলিসি ফাইন্ডিং ত্রুটি নীতি লঙ্ঘন ত্রুটি কোটা ত্রুটি রেঞ্জ ত্রুটি অনুরোধের ত্রুটি সংস্থান সীমা সীমা ছাড়িয়ে যাওয়া ত্রুটি সেটিং ত্রুটি ভাগ করা সেট ত্রুটি সাইজলিমিট ত্রুটি স্ট্রিংফরমেট ত্রুটি স্ট্রিং দৈর্ঘ্যের ত্রুটি Urlফিল্ড ত্রুটি ইউজারটিউব তালিকাভুক্তির ত্রুটি
HTTP অনুরোধ
POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:mutate
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
customerId | প্রয়োজন। গ্রাহকের আইডি যার সম্পদ পরিবর্তন করা হচ্ছে। |
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "mutateOperations": [ { object ( |
ক্ষেত্র | |
---|---|
mutateOperations[] | প্রয়োজন। স্বতন্ত্র সম্পদে সঞ্চালনের জন্য ক্রিয়াকলাপের তালিকা। |
partialFailure | সত্য হলে, সফল অপারেশন করা হবে এবং অবৈধ অপারেশন ত্রুটি ফিরিয়ে দেবে। যদি মিথ্যা হয়, সমস্ত ক্রিয়াকলাপ একটি লেনদেনে করা হবে যদি এবং শুধুমাত্র যদি সেগুলি বৈধ হয়। ডিফল্ট মিথ্যা. |
validateOnly | সত্য হলে, অনুরোধটি যাচাই করা হয় কিন্তু কার্যকর করা হয় না। শুধুমাত্র ত্রুটিগুলি ফেরত দেওয়া হয়, ফলাফল নয়। |
responseContentType | প্রতিক্রিয়া কন্টেন্ট টাইপ সেটিং। মিউটেশনের পরে মিউটেবল রিসোর্স বা রিসোর্সের নাম রিটার্ন করা উচিত কিনা তা নির্ধারণ করে। রিসোর্সের উপযুক্ত প্রতিক্রিয়া ক্ষেত্র থাকলেই পরিবর্তনযোগ্য সম্পদ ফেরত দেওয়া হবে। উদাহরণস্বরূপ, MutateCampaignResult.campaign। |
প্রতিক্রিয়া শরীর
GoogleAdsService.Mutate
এর জন্য প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "partialFailureError": { object ( |
ক্ষেত্র | |
---|---|
partialFailureError | আংশিক ব্যর্থতা মোডে অপারেশন ব্যর্থতার সাথে সম্পর্কিত ত্রুটি৷ শুধুমাত্র যখন আংশিক ব্যর্থতা = সত্য এবং সমস্ত ত্রুটিগুলি অপারেশনগুলির মধ্যে ঘটে তখনই ফেরত দেওয়া হয়৷ অপারেশনের বাইরে কোনো ত্রুটি দেখা দিলে (উদাহরণস্বরূপ, প্রমাণীকরণের ত্রুটি), আমরা একটি RPC স্তরের ত্রুটি ফেরত দিই। |
mutateOperationResponses[] | mutate জন্য সব প্রতিক্রিয়া. |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/adwords
আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।