factories proporciona una interfaz de alto nivel para crear operaciones y recursos con la biblioteca cliente.
Los métodos de factoría se generan automáticamente para todos los recursos, enumeraciones, operaciones y tipos de servicio que proporciona la API de Google Ads.
Operaciones
La biblioteca proporciona métodos de conveniencia client.operation.create_resource.<resource_type>, client.operation.update_resource.<resource_type> y client.operation.remove_resource.<resource_type> para crear operaciones fácilmente y trabajar con la API de Google Ads.
Este es un ejemplo para crear un recurso:
campaign_budget_operation = client.operation.create_resource.campaign_budget do |cb|
cb.name = "Interplanetary Budget #{(Time.new.to_f * 1000).to_i}"
cb.delivery_method = :STANDARD
cb.amount_micros = 500000
end
return_budget = client.service.campaign_budget.mutate_campaign_budgets(
customer_id,
[campaign_budget_operation]
)
Ten en cuenta que el objeto que se muestra en el bloque cb es una instancia nueva de CampaignBudget que puedes mutar y se muestra la operación de creación adecuada para CampaignBudgetService.
Del mismo modo, proporcionamos métodos convenientes para la actualización:
# if you only have a resource name
update_operation = client.operation.update_resource.campaign(campaign_resource_name) do |camp|
camp.status = :PAUSED
end
campaign_service.mutate_campaigns(customer_id, [update_operation])
# if you have a full resource proto
update_operation = client.operation.update_resource.campaign(campaign) do
campaign.name = "A different interplanetary Cruise #{(Time.new.to_f * 1000).to_i}"
end
campaign_service.mutate_campaigns(customer_id, [update_operation])
Estas llamadas muestran una operación de actualización bien formada, con una máscara de campo prepropagada para actualizar el recurso en la API de Google Ads.
A continuación, se muestra un ejemplo de cómo quitar un recurso con una ruta de acceso de recursos:
remove_operation = client.operation.remove_resource.campaign(campaign_resource_name)
campaign_service.mutate_campaigns(customer_id, [remove_operation])
Si prefieres trabajar con la operación por tu cuenta, puedes obtener una operación sin procesar y, luego, propagar los campos de forma manual.
operation = client.operation.campaign
Recursos
La biblioteca proporciona client.resource.<resource_type> como una forma conveniente de inicializar objetos de recursos:
campaign.network_settings = client.resource.network_settings do |ns|
ns.target_google_search = true
ns.target_search_network = true
ns.target_content_network = false
ns.target_partner_search_network = false
end
Se genera una instancia nueva del tipo de recurso solicitado en el bloque pasado para configurar los campos.
Servicios
La biblioteca proporciona client.service.<service_name> como una forma conveniente de obtener objetos de servicio:
campaign_service = client.service.campaign
Enumeraciones
Te recomendamos que uses la sintaxis de símbolos para configurar de forma estática los campos de enumeración (p.ej., campaign.status = :PAUSED). Sin embargo, si deseas enumerar todos los valores válidos de una enumeración, también proporcionamos métodos para ello:
client.enum.ad_type.each { |x| p x }
:SHOPPING_PRODUCT_AD
:GMAIL_AD
:UNKNOWN
:UNSPECIFIED
:CALL_ONLY_AD
:VIDEO_AD
:IMAGE_AD
:EXPANDED_DYNAMIC_SEARCH_AD
:RESPONSIVE_DISPLAY_AD
:TEXT_AD
:LEGACY_RESPONSIVE_DISPLAY_AD
:LEGACY_APP_INSTALL_AD
:APP_AD
:SHOPPING_SMART_AD
:EXPANDED_TEXT_AD
:HOTEL_AD
:RESPONSIVE_SEARCH_AD
Cómo configurar explícitamente las versiones de la API de Google Ads
También puedes establecer una versión de forma explícita:
client.resource.v19.[entity]
client.operation.v19.[operation]
client.service.v19.[service]
client.enum.v19.[enum]