factories
ma ogólny interfejs do tworzenia operacji i zasobów za pomocą biblioteki klienta.
Metody zastosowane do fabryk są generowane automatycznie dla wszystkich zasobów, wyliczeń, operacji i typów usług udostępnianych przez interfejs Google Ads API.
Operacje
Biblioteka udostępnia metody client.operation.create_resource.<resource_type>
, client.operation.update_resource.<resource_type>
i client.operation.remove_resource.<resource_type>
, które ułatwiają tworzenie operacji związanych z interfejsem Google Ads API.
Oto przykład tworzenia zasobu:
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]
)
Zwróć uwagę, że obiekt przekazany do bloku cb
jest nową instancją CampaignBudget
, którą możesz następnie przekształcić i zwracana jest odpowiednia operacja tworzenia dla CampaignBudgetService
.
Udostępniamy też wygodne metody aktualizowania:
# 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])
Te wywołania zwracają prawidłową operację aktualizacji ze wstępnie wypełnioną maską pola umożliwiającą zaktualizowanie zasobu w interfejsie Google Ads API.
Oto przykład usuwania zasobu przy użyciu ścieżki zasobu:
remove_operation = client.operation.remove_resource.campaign(campaign_resource_name)
campaign_service.mutate_campaigns(customer_id, [remove_operation])
Jeśli wolisz samodzielnie pracować nad tą operacją, możesz pobrać operację nieprzetworzoną, a potem ręcznie wypełnić pola.
operation = client.operation.campaign
Zasoby
Biblioteka udostępnia client.resource.<resource_type>
jako wygodny sposób inicjowania obiektów zasobów:
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
Nowa instancja żądanego typu zasobu jest przekazywana do przekazanego bloku na potrzeby pól ustawień.
Usługi
client.service.<service_name>
to wygodny sposób na uzyskiwanie w niej obiektów usługi:
campaign_service = client.service.campaign
Wartości w polu enum
Do statycznego ustawiania pól wyliczenia zalecamy używanie składni symboli (np. campaign.status = :PAUSED
). Jeśli jednak chcesz wyliczyć wszystkie prawidłowe wartości, udostępniamy też metody, które to umożliwiają:
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
Bezpośrednie ustawianie wersji interfejsu Google Ads API
Możesz też samodzielnie ustawić wersję:
client.resource.v17.[entity]
client.operation.v17.[operation]
client.service.v17.[service]
client.enum.v17.[enum]