إعداد كائنات رسائل فارغة كحقول

في Google Ads API، تُعرَّف بعض حقول الرسائل بأنها عناصر رسائل فارغة، مثل campaign.manual_cpm، أو قد تتضمن حقولاً اختيارية فقط لا تحتاج إلى ضبطها، مثل campaign.manual_cpc. من المهم تعيين هذه الحقول لإطلاع واجهة برمجة التطبيقات على إستراتيجية عروض الأسعار التي سيتم استخدامها للحملة المحددة، ولكن لا يكون الأمر سهلاً عندما تكون الرسائل فارغة.

عند تعديل الحقل campaign.name، وهو سلسلة، نحدّده من خلال تحديثه مباشرة كما لو كان سمة كائن Python عادية:

campaign.name = "Test campaign value"

campaign.manual_cpc هو حقل مدمج، مما يعني أنه يحتوي على رسالة نموذج أولي أخرى وليس نوعًا أوليًا، مثل سلسلة. يمكنك تحديث حقوله مباشرةً أيضًا:

campaign.manual_cpc.enhanced_cpc_enabled = True

سيؤدي ذلك إلى إعلام واجهة برمجة التطبيقات بأن هذه الحملة لديها استراتيجية عروض أسعار بقيمة manual_cpc مع تفعيل تكلفة النقرة المحسّنة.

ولكن ماذا لو كنت تريد استخدام manual_cpm، وهو فارغ؟ أو manual_cpc دون تمكين تكلفة النقرة المحسّنة؟ ولإجراء ذلك، ستحتاج إلى نسخ مثيل منفصل للفصل الدراسي إلى الحملة، على سبيل المثال:

client = GoogleAdsClient.load_from_storage()

empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)

لاحظ كيف يتم تحديد manual_cpm للعنصر campaign:

name {
  value: "Test campaign value"
}
manual_cpm {
}

تم ضبط الحقل manual_cpm، ولكن لا يتضمن أي من حقوله قيمًا. عند إرسال الطلب إلى واجهة برمجة التطبيقات التي تستخدم هذا النمط، يمكنك التحقُّق من إعداد كائن الرسالة الفارغ بشكل صحيح من خلال تفعيل تسجيل الدخول وفحص حمولة الطلب.