factories
는 클라이언트 라이브러리를 사용하여 작업과 리소스를 생성하기 위한 상위 수준 인터페이스를 제공합니다.
팩토리 메서드는 Google Ads API에서 제공하는 모든 리소스, 열거형, 작업, 서비스 유형에 대해 자동으로 생성됩니다.
운영
이 라이브러리는 Google Ads API를 사용하는 작업을 쉽게 만들 수 있는 client.operation.create_resource.<resource_type>
, client.operation.update_resource.<resource_type>
, client.operation.remove_resource.<resource_type>
편의 메서드를 제공합니다.
다음은 리소스를 만드는 예입니다.
campaign_budget_operation = client.operation.create_resource.campaign_budget do |cb|
cb.name = client.wrapper.string(
"Interplanetary Budget #{(Time.new.to_f * 1000).to_i}",
)
cb.delivery_method = :STANDARD
cb.amount_micros = client.wrapper.int64(500000)
end
return_budget = client.service.campaign_budget.mutate_campaign_budgets(
customer_id,
[campaign_budget_operation]
)
cb
블록에 얻은 객체는 이후에 변경할 수 있는 CampaignBudget
의 새 인스턴스이며 CampaignBudgetService
에 적절한 만들기 연산이 반환됩니다.
마찬가지로 다음과 같은 업데이트를 위한 편의 메서드도 제공합니다.
# 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 = client.wrapper.string(
"A different interplanetary Cruise #{(Time.new.to_f * 1000).to_i}",
)
end
campaign_service.mutate_campaigns(customer_id, [update_operation])
이러한 호출은 필드 마스크가 미리 채워진 올바른 형식의 업데이트 작업을 반환하여 Google Ads API의 리소스를 업데이트합니다.
다음은 리소스 경로를 사용하여 리소스를 삭제하는 예입니다.
remove_operation = client.operation.remove_resource.campaign(campaign_resource_name)
campaign_service.mutate_campaigns(customer_id, [remove_operation])
작업을 직접 작업하려면 원시 작업을 가져온 다음 수동으로 필드를 채울 수 있습니다.
operation = client.operation.campaign
자료
라이브러리는 리소스 객체를 초기화하는 편리한 방법으로 client.resource.<resource_type>
를 제공합니다.
campaign.network_settings = client.resource.network_settings do |ns|
ns.target_google_search = client.wrapper.bool(true)
ns.target_search_network = client.wrapper.bool(true)
ns.target_content_network = client.wrapper.bool(false)
ns.target_partner_search_network = client.wrapper.bool(false)
end
요청된 리소스 유형의 새 인스턴스는 필드 설정을 위해 전달된 블록에 전달됩니다.
서비스
라이브러리는 서비스 객체를 가져오는 편리한 방법으로 client.service.<service_name>
를 제공합니다.
campaign_service = client.service.campaign
열거형
enum 필드를 정적으로 설정하려면 기호 구문을 사용하는 것이 좋습니다(예: campaign.status = :PAUSED
). 그러나 enum에 유효한 모든 값을 열거하려면 다음과 같은 메서드도 제공합니다.
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 버전을 명시적으로 설정하기
버전을 명시적으로 설정할 수도 있습니다.
client.resource.v16.[entity]
client.operation.v16.[operation]
client.service.v16.[service]
client.enum.v16.[enum]