Ustawianie pustych obiektów wiadomości jako pól

W interfejsie Google Ads API niektóre pola wiadomości służą do wskazywania wybranej strategii ustalania stawek w przypadku Campaign. Mogą to być:

Pamiętaj, że pola strategii ustalania stawek w Campaign należą do grupy bidding_strategy oneof. Ustawienie nowej strategii ustalania stawek, takiej jak manual_cpm lub manual_cpc, powoduje niejawne wyczyszczenie wcześniej skonfigurowanej strategii ustalania stawek w tej grupie oneof.

Aby zaktualizować pole pierwotne, takie jak campaign.name, ustaw je bezpośrednio:

campaign.name = "Test campaign value"

Aby zaktualizować zagnieżdżoną wiadomość z polami podrzędnymi, które można ustawić, np. campaign.manual_cpc podczas włączania ulepszonego CPC, ustaw ją w ten sposób:

campaign.manual_cpc.enhanced_cpc_enabled = True

Ustawianie pustych wiadomości

Aby użyć strategii ustalania stawek, takiej jak manual_cpm, która jest pustą wiadomością:

  1. Pobierz pustą instancję typu wiadomości (ManualCpm).
  2. Użyj client.copy_from, aby przypisać tę pustą instancję do pola kampanii.
  3. Ręcznie dodaj nazwę pola (manual_cpm) do update_mask w CampaignOperation. Pomocnik maski pola nie może automatycznie wykryć, że pusta wiadomość została ustawiona w sposób jawny.
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 {
# }

Ustawianie wiadomości z opcjonalnymi polami podrzędnymi

Aby użyć manual_cpc jako strategii ustalania stawek bez włączania enhanced_cpc_enabled, możesz spróbować podejścia podobnego do ManualCpm. Jednak ponieważ ManualCpc ma pola podrzędne, dodanie manual_cpc do update_mask powoduje błąd FieldMaskError.FIELD_HAS_SUBFIELDS. Gdy wiadomość w masce ma pola podrzędne, interfejs API wymaga większej szczegółowości.

Aby prawidłowo ustawić campaign.manual_cpc i jednocześnie upewnić się, że enhanced_cpc_enabled pozostanie nieustawione:

  1. Utwórz instancję pustego ManualCpc obiektu i skopiuj ją do campaign.manual_cpc za pomocą client.copy_from.
  2. Ręcznie dodaj ścieżkę do każdego modyfikowalnego pola podrzędnego ManualCpc do update_mask w CampaignOperation. W tym przypadku odpowiednim polem podrzędnym jest 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.

Gdy wysyłasz prośby za pomocą tych wzorców, możesz sprawdzić ładunek, włączając logowanie i sprawdzając prośbę.