Fabrikalar

factories, işlem ve kaynak oluşturmak için üst düzey bir arayüz sağlar değiştirme işlemini uygulayın.

Fabrika yöntemleri tüm kaynaklar, enum'lar, işlemlerini ve Google Ads API tarafından sağlanan hizmet türlerini kapsar.

İşlemler

Kitaplıkta client.operation.create_resource.<resource_type>, client.operation.update_resource.<resource_type> ve client.operation.remove_resource.<resource_type> Google Ads API ile çalışacak işlemleri kolayca oluşturmanızı sağlayan kolaylık yöntemleri.

Kaynak oluşturmayla ilgili bir örnek:

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]
)

cb bloğuna verilen nesnenin yeni bir örnek olduğuna dikkat edin: CampaignBudget sonra bunu değiştirebilirsiniz ve CampaignBudgetService döndürüldü.

Benzer şekilde, güncelleme için kolaylık yöntemleri sunarız:

# 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])

Bu çağrılar, düzgün şekilde oluşturulmuş bir güncelleme işlemi döndürüyor ve Google Ads API'de kaynağı güncellemek için alan maskesini kullanın.

Kaynak yolu kullanarak kaynak kaldırmayla ilgili bir örnek aşağıda verilmiştir:

remove_operation = client.operation.remove_resource.campaign(campaign_resource_name)
campaign_service.mutate_campaigns(customer_id, [remove_operation])

İşlemle kendiniz çalışmayı tercih ederseniz ham işlem alabilirsiniz ve ardından alanları manuel olarak doldurun.

operation = client.operation.campaign

Kaynaklar

Kitaplık sayesinde client.resource.<resource_type>, kaynak nesnelerini ilk kullanıma hazırlayın:

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

İstenen kaynak türünün yeni bir örneği, şunun için iletilen bloka verildi: ayar alanlarını da kullanabilirsiniz.

Hizmetler

Kitaplık sayesinde client.service.<service_name>, hizmet nesnelerini al:

campaign_service = client.service.campaign

Sıralamalar

Numaralandırma alanları statik olarak ayarlanırken sembol söz dizimini kullanmanız önerilir (ör. campaign.status = :PAUSED) bilgileri gösterilir. Ancak tüm anahtar kelimeleri bir enum için geçerli değerleri içeriyorsa, bunun için de yöntemler sağlarız:

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

Google Ads API sürümlerini açık bir şekilde ayarlama

Ayrıca, açıkça bir sürüm de ayarlayabilirsiniz:

client.resource.v22.[entity]
client.operation.v22.[operation]
client.service.v22.[service]
client.enum.v22.[enum]