將空白訊息物件設為欄位

在 Google Ads API 中，部分訊息欄位用於指出 Campaign 的出價策略選項。可能的形式包括：

如要更新原始欄位 (例如 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. 在 CampaignOperation 上，手動將欄位名稱 (manual_cpm) 新增至 update_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. 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 錯誤。如果遮罩中的訊息有子欄位，API 就需要更具體地指定。

如要正確設定 campaign.manual_cpc，同時確保 enhanced_cpc_enabled 保持未設定狀態，請按照下列步驟操作：

  1. 建立空白 ManualCpc 物件例項，並指派給 campaign.manual_cpc。
  2. 手動將 ManualCpc 各個可變動子欄位的路徑新增至 CampaignOperation 的 update_mask。在本例中，相關子欄位為 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.

使用這些模式傳送要求時，您可以啟用記錄並檢查要求，藉此驗證酬載。