Menetapkan objek pesan kosong sebagai kolom

Di Google Ads API, beberapa kolom pesan digunakan untuk menunjukkan pilihan strategi bidding untuk Campaign. Di antaranya yaitu:

Perhatikan bahwa kolom strategi bidding di Campaign termasuk dalam grup bidding_strategy oneof. Menetapkan strategi bidding baru seperti manual_cpm atau manual_cpc secara implisit akan menghapus strategi bidding yang sebelumnya dikonfigurasi dalam grup oneof tersebut.

Untuk memperbarui kolom primitif seperti campaign.name, Anda dapat menyetelnya secara langsung:

campaign.name = "Test campaign value"

Untuk mengupdate pesan bertingkat dengan sub-bidang yang dapat disetel, seperti campaign.manual_cpc saat mengaktifkan CPC yang ditingkatkan, tetapkan seperti berikut:

campaign.manual_cpc.enhanced_cpc_enabled = True

Menetapkan pesan yang benar-benar kosong

Untuk menggunakan strategi bidding seperti manual_cpm, yang merupakan pesan kosong:

  1. Dapatkan instance kosong dari jenis pesan (ManualCpm).
  2. Gunakan client.copy_from untuk menetapkan instance kosong ini ke kolom kampanye.
  3. Tambahkan nama kolom (manual_cpm) secara manual ke update_mask di CampaignOperation. Helper mask kolom tidak dapat mendeteksi secara otomatis bahwa pesan kosong telah ditetapkan secara eksplisit.
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 {
# }

Menetapkan pesan dengan sub-kolom opsional

Untuk menggunakan manual_cpc sebagai strategi bidding tanpa mengaktifkan enhanced_cpc_enabled, Anda dapat mencoba pendekatan yang mirip dengan ManualCpm. Namun, karena ManualCpc memiliki sub-bidang, menambahkan manual_cpc ke update_mask akan menghasilkan error FieldMaskError.FIELD_HAS_SUBFIELDS. API memerlukan spesifisitas yang lebih tinggi saat pesan dalam mask memiliki sub-bidang.

Untuk menyetel campaign.manual_cpc dengan benar sambil memastikan enhanced_cpc_enabled tetap tidak disetel:

  1. Buat instance objek ManualCpc kosong dan salin ke campaign.manual_cpc menggunakan client.copy_from.
  2. Tambahkan jalur ke setiap sub-kolom yang dapat diubah dari ManualCpc secara manual ke update_mask di CampaignOperation. Dalam hal ini, sub-bidang yang relevan adalah 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.

Saat mengirim permintaan menggunakan pola ini, Anda dapat memverifikasi payload dengan mengaktifkan logging dan memeriksa permintaan.