공장

factories는 작업 및 리소스 생성을 위한 상위 수준 인터페이스를 제공합니다. 사용할 수 있습니다

팩토리 메서드는 모든 리소스, enum, Google Ads API에서 제공하는 서비스 유형 및 운영 체제에 대한 간단한 정보입니다.

운영

라이브러리는 client.operation.create_resource.<resource_type>, client.operation.update_resource.<resource_type>, <ph type="x-smartling-placeholder">client.operation.remove_resource.<resource_type></ph> 편의 메서드를 사용하여 Google Ads API에서 작동하는 작업을 쉽게 만들 수 있습니다.

다음은 리소스를 만드는 예시입니다.

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 블록에 반환된 객체는 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 = "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 = true
  ns.target_search_network = true
  ns.target_content_network = false
  ns.target_partner_search_network = false
end

요청된 리소스 유형의 새 인스턴스가 필드를 설정하기 위해 전달된 블록에 제공됩니다.

서비스

라이브러리는 다음과 같은 편리한 방법으로 client.service.<service_name>를 제공합니다. 서비스 객체를 가져옵니다.

campaign_service = client.service.campaign

열거형

enum 필드를 정적으로 설정하려면 기호 문법을 사용하는 것이 좋습니다. (예: campaign.status = :PAUSED)을 입력합니다. 그러나 한 개 이상의 값이 유효하면 이를 위한 메서드도 제공됩니다.

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.v17.[entity]
client.operation.v17.[operation]
client.service.v17.[service]
client.enum.v17.[enum]