ضبط عناصر الرسائل الفارغة كحقول

في 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، وهي رسالة فارغة:

  1. احصل على مثيل فارغ من نوع الرسالة (ManualCpm).
  2. استخدِم client.copy_from لتعيين هذا العنصر الفارغ إلى حقل الحملة.
  3. أضِف اسم الحقل (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، اتّبِع الخطوات التالية:

  1. أنشئ عنصر ManualCpc فارغًا وعيّنه إلى campaign.manual_cpc.
  2. أضِف يدويًا المسار إلى كل حقل فرعي قابل للتغيير في 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.

عند إرسال طلبات باستخدام هذه الأنماط، يمكنك التحقّق من الحمولة من خلال تفعيل التسجيل وفحص الطلب.