ตั้งค่าออบเจ็กต์ข้อความที่ว่างเปล่าเป็นฟิลด์

ใน 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 เมื่อเปิดใช้ 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 API ต้องการความเฉพาะเจาะจงมากขึ้นเมื่อข้อความในมาสก์มีช่องย่อย

วิธีตั้งค่า 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.

เมื่อส่งคำขอโดยใช้รูปแบบเหล่านี้ คุณสามารถยืนยันเพย์โหลดได้โดยเปิดใช้การบันทึกและตรวจสอบคำขอ