將空白訊息物件設為欄位

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

請注意，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. 在CampaignOperation上，手動將欄位名稱 (manual_cpm) 新增至 update_mask。欄位遮罩輔助程式無法自動偵測到已明確設定的空白訊息。
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 物件，並使用 client.copy_from 將其複製到 campaign.manual_cpc。
  2. 手動將 ManualCpc 的每個可變動子欄位路徑，新增至 CampaignOperation 的 update_mask。在本例中，相關子欄位為 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.

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