En la API de Google Ads, algunos campos de mensaje se definen como objetos de mensaje vacíos, como campaign.manual_cpm
, o bien es posible que solo tengan campos opcionales que no es necesario configurar, como campaign.manual_cpc
. Es importante configurar estos campos para indicarle a la API qué estrategia de ofertas usar para una campaña determinada. Sin embargo, no resulta intuitivo cuando los mensajes están vacíos.
Cuando se actualiza el campo campaign.name
, que es una string, configuramos el campo actualizándolo directamente como si fuera un atributo de objeto de Python normal:
campaign.name = "Test campaign value"
campaign.manual_cpc
es un campo anidado, lo que significa que contiene otro mensaje protobuf y no un tipo primitivo, como una string. También puedes actualizar sus campos directamente:
campaign.manual_cpc.enhanced_cpc_enabled = True
Esto le indicará a la API que esta campaña tiene una estrategia de ofertas de manual_cpc
con el CPC avanzado habilitado.
Pero ¿qué sucede si deseas usar manual_cpm
, que está vacío? ¿O manual_cpc
sin habilitar el CPC avanzado? Para ello, deberás copiar una instancia vacía de la clase en la campaña, por ejemplo:
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
Ten en cuenta cómo se especifica manual_cpm
para el objeto campaign
:
name {
value: "Test campaign value"
}
manual_cpm {
}
El campo manual_cpm
está configurado, pero ninguno de sus campos tiene valores. Cuando envías
una solicitud a la API que usa este patrón, puedes verificar que estás configurando el
objeto de mensaje vacío de forma correcta si habilitas logging y, luego, inspeccionas la
carga útil de la solicitud.
Por último, deberás agregar de forma manual este campo al update_mask
del objeto de la solicitud. El auxiliar de máscara de campo no tiene un mecanismo para determinar la diferencia entre un campo que se configuró de forma explícita como un objeto vacío y un campo que no se configuró.
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")