খালি বার্তা বস্তুগুলিকে ক্ষেত্র হিসেবে সেট করুন

গুগল অ্যাডস এপিআই-তে, একটি ক্যাম্পেইনের জন্য বিডিং স্ট্র্যাটেজি বেছে নেওয়ার বিষয়টি নির্দেশ করতে কিছু মেসেজ ফিল্ড ব্যবহার করা হয়। এগুলো হতে পারে:

  • প্রকৃতপক্ষে খালি বার্তা: উদাহরণস্বরূপ, campaign.manual_cpm কোনো সংজ্ঞায়িত সাবফিল্ড নেই।
  • ঐচ্ছিক ফিল্ডসহ বার্তা: উদাহরণস্বরূপ, campaign.manual_cpc enhanced_cpc_enabled নামক একটি ঐচ্ছিক সাবফিল্ড রয়েছে।

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

campaign.name = "Test campaign value"

এনহ্যান্সড সিপিসি সক্রিয় করার সময় campaign.manual_cpc এর মতো সেটযোগ্য সাবফিল্ডসহ কোনো নেস্টেড মেসেজ আপডেট করতে, এটিকে নিম্নরূপে সেট করুন:

campaign.manual_cpc.enhanced_cpc_enabled = True

সম্পূর্ণ খালি বার্তা সেট করুন

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

  1. মেসেজ টাইপের ( ManualCpm ) একটি খালি ইনস্ট্যান্স নিন।
  2. এই খালি ইনস্ট্যান্সটিকে ক্যাম্পেইনের ফিল্ডে অ্যাসাইন করতে client.copy_from ব্যবহার করুন।
  3. CampaignOperation এর update_mask এ ফিল্ডের নাম ( manual_cpm ) ম্যানুয়ালি যোগ করুন। ফিল্ড মাস্ক হেল্পার স্বয়ংক্রিয়ভাবে শনাক্ত করতে পারে না যে একটি খালি বার্তা স্পষ্টভাবে সেট করা হয়েছে। 
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. Manually add "manual_cpm" to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, 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 অবজেক্ট তৈরি করুন এবং এটিকে campaign.manual_cpc তে অ্যাসাইন করুন।
  2. CampaignOperation এর update_mask এ ManualCpc এর প্রতিটি পরিবর্তনযোগ্য সাবফিল্ডের পাথ ম্যানুয়ালি যোগ করুন। এক্ষেত্রে, প্রাসঙ্গিক সাবফিল্ডটি হলো enhanced_cpc_enabled । 
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Instantiate and assign an empty ManualCpc
campaign.manual_cpc = client.get_type('ManualCpc')

# 2. Manually add the subfield path to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, 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.

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