في Google Ads API، يتم استخدام بعض حقول الرسائل للإشارة إلى اختيار استراتيجية عروض أسعار لأحد الحملات. ويتّخذ هذا الأشكال التالية:
- الرسائل الفارغة تمامًا: على سبيل المثال، لا يحتوي
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، وهي رسالة فارغة:
- احصل على مثيل فارغ من نوع الرسالة
(
ManualCpm). - استخدِم
client.copy_fromلتعيين هذا العنصر الفارغ إلى حقل الحملة. - أضِف اسم الحقل (
manual_cpm) يدويًا إلىupdate_maskفيCampaignOperation. لا يمكن لأداة المساعدة الخاصة بقناع الحقل أن ترصد تلقائيًا أنّه تم ضبط رسالة فارغة بشكل صريح.
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 {
# }
ضبط الرسائل باستخدام حقول فرعية اختيارية
لاستخدام manual_cpc كاستراتيجية عروض أسعار بدون تفعيل enhanced_cpc_enabled، يمكنك تجربة طريقة مشابهة لطريقة ManualCpm.
ومع ذلك، بما أنّ ManualCpc يتضمّن حقولاً فرعية، ستؤدي إضافة manual_cpc إلى update_mask إلى حدوث خطأ FieldMaskError.FIELD_HAS_SUBFIELDS. تتطلّب واجهة برمجة التطبيقات المزيد من التحديد عند احتواء رسالة في القناع على حقول فرعية.
لضبط قيمة campaign.manual_cpc بشكل صحيح مع ضمان عدم ضبط قيمة enhanced_cpc_enabled، اتّبِع الخطوات التالية:
- أنشئ عنصر
ManualCpcفارغًا وعيّنه إلىcampaign.manual_cpc. - أضِف يدويًا المسار إلى كل حقل فرعي قابل للتغيير في
ManualCpcإلىupdate_maskفيCampaignOperation. في هذه الحالة، الحقل الفرعي ذو الصلة هو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.
عند إرسال طلبات باستخدام هذه الأنماط، يمكنك التحقّق من الحمولة من خلال تفعيل التسجيل وفحص الطلب.