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

في 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 عند تفعيل "تكلفة النقرة المحسّنة"، اضبطها على النحو التالي:

campaign.manual_cpc.enhanced_cpc_enabled = True

ضبط رسائل فارغة تمامًا

لاستخدام استراتيجية عروض أسعار مثل manual_cpm، وهي رسالة فارغة، اتّبِع الخطوات التالية:

  1. احصل على مثيل فارغ لنوع الرسالة (ManualCpm).
  2. استخدِم client.copy_from لتعيين هذا العنصر الفارغ إلى حقل الحملة.
  3. أضِف اسم الحقل (manual_cpm) يدويًا إلى update_mask في CampaignOperation. لا يمكن لمساعد قناع الحقل أن يرصد تلقائيًا أنّه تم ضبط رسالة فارغة بشكل صريح.
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 {
# }

ضبط الرسائل باستخدام حقول فرعية اختيارية

لاستخدام 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 باستخدام client.copy_from.
  2. أضِف يدويًا المسار إلى كل حقل فرعي قابل للتعديل في ManualCpc إلى update_mask في CampaignOperation. في هذه الحالة، الحقل الفرعي ذو الصلة هو 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.

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