Google Ads API では、一部のメッセージ フィールドは空のメッセージ オブジェクト（campaign.manual_cpm など）として定義されています。また、設定が不要なオプション フィールドのみを持つフィールド（campaign.manual_cpc など）もあります。これらのフィールドを設定することは、対象のキャンペーンで使用する入札戦略を API に伝えるために重要ですが、メッセージが空の場合には直感的に理解できません。
文字列である campaign.name フィールドを更新する場合は、通常の Python オブジェクト属性のように直接更新してフィールドを設定します。
campaign.name = "Test campaign value"
campaign.manual_cpc はネストされたフィールドです。つまり、文字列などのプリミティブ型ではなく、別の protobuf メッセージが含まれています。フィールドを直接更新することもできます。
campaign.manual_cpc.enhanced_cpc_enabled = True
これにより、このキャンペーンの入札戦略が manual_cpc で、拡張クリック単価が有効になっていることが API に通知されます。
しかし、空の manual_cpm を使用する場合はどうすればよいでしょうか。または、拡張クリック単価を有効にせずに manual_cpc に設定できますか？これを行うには、クラスの空のインスタンスを個別にキャンペーンにコピーする必要があります。次に例を示します。
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
campaign オブジェクトに manual_cpm がどのように指定されるかに注意してください。
name {
value: "Test campaign value"
}
manual_cpm {
}
manual_cpm フィールドが設定されていますが、どのフィールドにも値がありません。このパターンを使用する API にリクエストを送信するときに、ロギングを有効にしてリクエスト ペイロードを調べることで、空のメッセージ オブジェクトが正しく設定されていることを確認できます。
最後に、このフィールドを手動でリクエスト オブジェクトの update_mask に追加する必要があります。フィールド マスク ヘルパーには、空のオブジェクトに明示的に設定されたフィールドと設定されていないフィールドの違いを判断するメカニズムがありません。
from google.api_core.protobuf_helpers import field_mask
campaign_operation.create = campaign
campaign_operation.update_mask = field_mask(None, campaign)
# Here we manually add the "manual_cpm" field
campaign_operation.update_mask.append("manual_cpm")