將空白訊息物件設為欄位

在 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.

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