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 বিজ্ঞাপন অ্যাকাউন্টে প্রয়োগ করা হবে যদি অনুরোধের প্রতিটি অপারেশন সফল হয়। সাধারণ ত্রুটিগুলির একটি তালিকা এবং কীভাবে সেগুলিকে সমাধান করতে হয় তার জন্য সাধারণ ত্রুটি নির্দেশিকাটি দেখুন৷
গেট দিয়ে অবজেক্ট পরিদর্শন করা (বঞ্চিত)
অবজেক্ট পরিবর্তন করার পাশাপাশি, প্রতিটি রিসোর্স টাইপ-নির্দিষ্ট পরিষেবাতে একটি একক সম্পদের সমস্ত বৈশিষ্ট্য পুনরুদ্ধারের জন্য একটি প্রাপ্ত পদ্ধতিও রয়েছে। এই পদ্ধতিটি একটি অনুরোধ গ্রহণ করে যার একমাত্র বৈশিষ্ট্য হল resource_name ।
একটি একক বস্তুর সমস্ত বৈশিষ্ট্য পুনরুদ্ধার করা সহজ করার জন্য Google Ads API দ্বারা উপলব্ধ পদ্ধতিগুলি হল একটি সুবিধা। যদিও এটি এপিআই শেখার জন্য বা ডিবাগিং বা শিক্ষার উদ্দেশ্যে একটি পৃথক বস্তু পরিদর্শন করার জন্য একটি দুর্দান্ত সরঞ্জাম, তবে আপনার অ্যাপটি প্রক্রিয়াকরণ বা প্রতিবেদনের জন্য বস্তু পুনরুদ্ধার করতে get পদ্ধতি ব্যবহার করা উচিত নয়। পরিবর্তে, GoogleAdsService ব্যবহার করুন, যেহেতু এটি আপনাকে বস্তুর শুধুমাত্র নির্দিষ্ট বৈশিষ্ট্যগুলি পুনরুদ্ধার করতে দেয়, কর্মক্ষমতা মেট্রিক্স পুনরুদ্ধার করতে সহায়তা করে এবং বড় ফলাফল সেটগুলির মাধ্যমে স্ট্রিমিংয়ের অনুমতি দেয়৷ যদি আপনার অ্যাপ প্রচুর পরিমাণে অনুরোধ জমা দেয়, তাহলে আপনি হারের সীমার সম্মুখীন হতে পারেন।