Boş ileti nesnelerini alan olarak ayarlama

Google Ads API'de, bazı ileti alanları Campaign için teklif stratejisi seçimi belirtmek amacıyla kullanılır. Bunlardan bazıları:

Campaign üzerindeki teklif stratejisi alanlarının bidding_strategy oneof grubuna ait olduğunu unutmayın. manual_cpm veya manual_cpc gibi yeni bir teklif stratejisi ayarladığınızda, söz konusu oneof grubunda daha önce yapılandırılmış tüm teklif stratejileri otomatik olarak temizlenir.

campaign.name gibi bir temel alanı güncellemek için doğrudan ayarlarsınız:

campaign.name = "Test campaign value"

İç içe yerleştirilmiş bir mesajı ayarlanabilir alt alanlarla güncellemek için (ör. geliştirilmiş TBM'yi etkinleştirirken) aşağıdaki şekilde ayarlayın: campaign.manual_cpc 

campaign.manual_cpc.enhanced_cpc_enabled = True

Gerçekten boş mesajlar ayarlama

manual_cpm gibi bir teklif stratejisi kullanmak için (boş mesaj):

  1. Mesaj türünün boş bir örneğini (ManualCpm) alın.
  2. Bu boş örneği kampanyanın alanına atamak için client.copy_from simgesini kullanın.
  3. Alan adını (manual_cpm) CampaignOperation üzerindeki update_mask öğesine manuel olarak ekleyin. Alan maskesi yardımcısı, boş bir mesajın açıkça ayarlandığını otomatik olarak algılayamaz.
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 {
# }

İsteğe bağlı alt alanlar içeren mesajları ayarlama

manual_cpc teklif stratejisini enhanced_cpc_enabled'ı etkinleştirmeden kullanmak için ManualCpm'a benzer bir yaklaşım deneyebilirsiniz. Ancak ManualCpc alt alanlara sahip olduğundan manual_cpc öğesini update_mask öğesine eklemek FieldMaskError.FIELD_HAS_SUBFIELDS hatasına neden olur. API, maskede alt alanlar içeren bir mesaj olduğunda daha fazla ayrıntı gerektirir.

campaign.manual_cpc değerini doğru şekilde ayarlamak ve enhanced_cpc_enabled değerinin ayarlanmamış kalmasını sağlamak için:

  1. Boş bir ManualCpc nesnesi oluşturun ve client.copy_from kullanarak campaign.manual_cpc içine kopyalayın.
  2. ManualCpc öğesinin her değiştirilebilir alt alanının yolunu CampaignOperation üzerindeki update_mask öğesine manuel olarak ekleyin. Bu durumda, ilgili alt alan enhanced_cpc_enabled olur.
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.

Bu kalıpları kullanarak istek gönderirken günlüğü etkinleştirip isteği inceleyerek yükü doğrulayabilirsiniz.