ফিল্ড হিসেবে খালি মেসেজ অবজেক্ট সেট করা

Google Ads API-তে, কিছু মেসেজ ফিল্ড Campaign-এর জন্য বিডিং স্ট্র্যাটেজির বিকল্প নির্দেশ করতে ব্যবহার করা হয়। এগুলি হতে পারে:

  • সম্পূর্ণ ফাঁকা মেসেজ: যেমন, campaign.manual_cpm-এ কোনও সাবফিল্ড নেই।
  • ঐচ্ছিক ফিল্ড সহ মেসেজ: যেমন, campaign.manual_cpc-এ ঐচ্ছিক সাবফিল্ড enhanced_cpc_enabled আছে।

মনে রাখবেন, Campaign-এ বিডিং স্ট্র্যাটেজি ফিল্ড bidding_strategy oneof গ্রুপের অন্তর্গত। manual_cpm বা manual_cpc-এর মতো নতুন বিডিং স্ট্র্যাটেজি সেট করলে, সেই oneof গ্রুপে আগে কনফিগার করা বিডিং স্ট্র্যাটেজি অটোমেটিক মুছে যায়।

campaign.name-এর মতো আদিম ফিল্ড আপডেট করতে, আপনি এটি সরাসরি সেট করেন:

campaign.name = "Test campaign value"

সেট করা যায় এমন সাবফিল্ড সহ নেস্ট করা মেসেজ আপডেট করতে, যেমন campaign.manual_cpc উন্নত CPC চালু করার সময়, এটি এইভাবে সেট করুন:

campaign.manual_cpc.enhanced_cpc_enabled = True

সত্যিই খালি মেসেজ সেট করুন

manual_cpm-এর মতো বিডিং স্ট্র্যাটেজি ব্যবহার করতে, যা একটি খালি মেসেজ:

  1. মেসেজের ধরনের (ManualCpm) একটি খালি ইনস্ট্যান্স পান।
  2. ক্যাম্পেনের ফিল্ডে এই খালি ইনস্ট্যান্স অ্যাসাইন করতে client.copy_from ব্যবহার করুন।
  3. ম্যানুয়ালি ফিল্ডের নাম (manual_cpm) CampaignOperation-এর update_mask-এ যোগ করুন। The ফিল্ড মাস্ক হেল্পার অটোমেটিক শনাক্ত করতে পারে না যে একটি খালি মেসেজ স্পষ্টভাবে সেট করা হয়েছে।
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Get an empty ManualCpm type.
empty_cpm = client.get_type("ManualCpm")

# 2. Copy it to the campaign's manual_cpm field.
client.copy_from(campaign.manual_cpm, empty_cpm)

# 3. Create the operation and manually add "manual_cpm" to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)
campaign_operation.update_mask.paths.append("manual_cpm")

# The resulting proto sent to the API will include:
# manual_cpm {
# }

ঐচ্ছিক সাবফিল্ড সহ মেসেজ সেট করা

enhanced_cpc_enabled চালু না করে বিডিং স্ট্র্যাটেজি হিসেবে manual_cpc ব্যবহার করতে, আপনি ManualCpm-এর মতো পদ্ধতি ব্যবহার করে দেখতে পারেন। তবে, ManualCpc-এ সাবফিল্ড থাকার কারণে, update_mask-এ manual_cpc যোগ করলে FieldMaskError.FIELD_HAS_SUBFIELDS সমস্যা হয়। মাস্কে কোনও মেসেজে সাবফিল্ড থাকলে, API-কে আরও নির্দিষ্ট হতে হবে।

enhanced_cpc_enabled আনসেট আছে কিনা তা নিশ্চিত করার সময় campaign.manual_cpc সঠিকভাবে সেট করতে:

  1. খালি ManualCpc অবজেক্ট ইনস্ট্যানশিয়েট করুন এবং client.copy_from ব্যবহার করে campaign.manual_cpc-এ কপি করুন।
  2. CampaignOperation-এ update_mask-এর ManualCpc-এর প্রতিটি পরিবর্তনযোগ্য সাবফিল্ডে ম্যানুয়ালি পাথ যোগ করুন। এই ক্ষেত্রে, প্রাসঙ্গিক সাবফিল্ড হল enhanced_cpc_enabled।
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Copy an empty ManualCpc object into campaign.manual_cpc.
client.copy_from(campaign.manual_cpc, client.get_type("ManualCpc"))

# 2. Manually add the subfield path to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)

# For ManualCpc, because it has subfields, you must specify the subfield
# path in the update_mask. This tells the API you are updating something
# within manual_cpc. By not setting enhanced_cpc_enabled on the campaign
# object, it defaults to false.
campaign_operation.update_mask.paths.append("manual_cpc.enhanced_cpc_enabled")

# The update_mask paths will include: ['manual_cpc.enhanced_cpc_enabled']
# This correctly signals to the API that ManualCpc is the chosen strategy,
# with enhanced_cpc_enabled in its default state.

এইসব প্যাটার্ন ব্যবহার করে অনুরোধ পাঠানোর সময়, আপনি লগিং চালু করে এবং অনুরোধটি পরীক্ষা করে পে-লোড যাচাই করতে পারবেন।