facebookbusiness 0.7.0.0 → 0.8.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8755dfc5017c9c8f8927b15ecaa86745fe13c0655ea8cbf25c406b07de558be
-  data.tar.gz: 8342e06de9d90d9225a725501312ed98332d3aa9ae1f0805508c72fb586a9fb9
+  metadata.gz: 1ec2c3003233735a142a752de0bb91e4119fa931d94c5c10c5a769a9c97110d6
+  data.tar.gz: 7e7094b3c29f41afbab98f3d5d7faf0bec900cae1642d1e39ee17cf19ba8e7d7
 SHA512:
-  metadata.gz: 473dd442cfe8a10935c731bd54b086d17786c7f91047b93d2270840a36c5c75ba102a7073316e49d3d189feb98bb97e58a1525eb684d1bdebdd5d5f69c8f66c7
-  data.tar.gz: 7e8a6cf4b89d4c5840f8e43f3b0ca35560a027dcd9fc58dc9c9b6a76650f1d2e8c48038f82d5c648ac01d26c799884fe59edf34b5a2905b439fbf0b32963e425
+  metadata.gz: dd97d6ee27e4dea44ab8db1c47a5949b9429e0d67ad51517a20729851050f03ee66f1b35ef80fc1729991dd2cb0cb347aaae28f764be36c0893e014918939db0
+  data.tar.gz: fb4e4a25f44130e2e61b5203ab248da4412c846e59912e736024eff096d8c57bae553423c5e2bccf15a0688d9a3503db1dedd0b2d43ad9ab08e9beb53ca8e4d9

data/lib/facebook_ads/ad_objects/ad.rb

@@ -123,7 +123,6 @@ module FacebookAds
     field :engagement_audience, 'bool'
     field :failed_delivery_checks, { list: 'DeliveryCheck' }
     field :id, 'string'
-    field :is_autobid, 'bool'
     field :issues_info, { list: 'AdgroupIssuesInfo' }
     field :last_updated_by_app_id, 'string'
     field :name, 'string'

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -77,6 +77,7 @@ module FacebookAds
       "THB",
       "TRY",
       "TWD",
+      "UAH",
       "USD",
       "UYU",
       "VND",
@@ -86,18 +87,12 @@ module FacebookAds
     PERMITTED_TASKS = [
       "ADVERTISE",
       "ANALYZE",
-      "CREATIVE",
-      "DRAFT",
-      "FB_EMPLOYEE_DSO_ADVERTISE",
       "MANAGE",
     ]
 
     TASKS = [
       "ADVERTISE",
       "ANALYZE",
-      "CREATIVE",
-      "DRAFT",
-      "FB_EMPLOYEE_DSO_ADVERTISE",
       "MANAGE",
     ]
 
@@ -118,6 +113,7 @@ module FacebookAds
       "FLIGHT",
       "HOME_LISTING",
       "HOTEL",
+      "LOCAL_SERVICE_BUSINESS",
       "LOCATION_BASED_ITEM",
       "MEDIA_TITLE",
       "OFFLINE_PRODUCT",
@@ -214,6 +210,7 @@ module FacebookAds
         api.has_param :after, 'string'
         api.has_param :business_id, 'string'
         api.has_param :category, { enum: -> { AdActivity::CATEGORY }}
+        api.has_param :data_source, { enum: -> { AdActivity::DATA_SOURCE }}
         api.has_param :extra_oids, { list: 'string' }
         api.has_param :limit, 'int'
         api.has_param :oid, 'string'
@@ -226,6 +223,7 @@ module FacebookAds
     has_edge :ad_place_page_sets do |edge|
       edge.get 'AdPlacePageSet'
       edge.post 'AdPlacePageSet' do |api|
+        api.has_param :category, { enum: -> { AdPlacePageSet::CATEGORY }}
         api.has_param :location_types, { list: { enum: -> { AdPlacePageSet::LOCATION_TYPES }} }
         api.has_param :name, 'string'
         api.has_param :parent_page, 'string'
@@ -235,6 +233,7 @@ module FacebookAds
 
     has_edge :ad_place_page_sets_async do |edge|
       edge.post 'AdPlacePageSet' do |api|
+        api.has_param :category, { enum: -> { AdPlacePageSet::CATEGORY }}
         api.has_param :location_types, { list: { enum: -> { AdPlacePageSet::LOCATION_TYPES }} }
         api.has_param :name, 'string'
         api.has_param :parent_page, 'string'
@@ -242,15 +241,6 @@ module FacebookAds
       end
     end
 
-    has_edge :ad_sets do |edge|
-      edge.delete do |api|
-        api.has_param :before_date, 'datetime'
-        api.has_param :delete_offset, 'int'
-        api.has_param :delete_strategy, { enum: %w{DELETE_ANY DELETE_ARCHIVED_BEFORE DELETE_OLDEST }}
-        api.has_param :object_count, 'int'
-      end
-    end
-
     has_edge :ad_studies do |edge|
       edge.get 'AdStudy'
     end
@@ -348,10 +338,6 @@ module FacebookAds
       end
     end
 
-    has_edge :adreportschedules do |edge|
-      edge.get
-    end
-
     has_edge :adrules_history do |edge|
       edge.get 'AdAccountAdRulesHistory' do |api|
         api.has_param :action, { enum: -> { AdAccountAdRulesHistory::ACTION }}
@@ -405,6 +391,7 @@ module FacebookAds
     has_edge :ads_volume do |edge|
       edge.get 'AdAccountAdVolume' do |api|
         api.has_param :page_id, 'int'
+        api.has_param :recommendation_type, { enum: -> { AdAccountAdVolume::RECOMMENDATION_TYPE }}
         api.has_param :show_breakdown_by_actor, 'bool'
       end
     end
@@ -528,6 +515,7 @@ module FacebookAds
         api.has_param :composer_type, 'string'
         api.has_param :container_type, { enum: -> { AdVideo::CONTAINER_TYPE }}
         api.has_param :content_category, { enum: -> { AdVideo::CONTENT_CATEGORY }}
+        api.has_param :creative_tools, 'string'
         api.has_param :description, 'string'
         api.has_param :embeddable, 'bool'
         api.has_param :end_offset, 'int'
@@ -581,6 +569,7 @@ module FacebookAds
         api.has_param :upload_session_id, 'string'
         api.has_param :upload_setting_properties, 'string'
         api.has_param :video_file_chunk, 'file'
+        api.has_param :video_id_original, 'string'
         api.has_param :video_start_time_ms, 'int'
         api.has_param :waterfall_id, 'string'
         api.accepts_files!
@@ -691,6 +680,7 @@ module FacebookAds
         api.has_param :promoted_object, 'object'
         api.has_param :source_campaign_id, 'string'
         api.has_param :special_ad_categories, { list: { enum: -> { Campaign::SPECIAL_AD_CATEGORIES }} }
+        api.has_param :special_ad_category_country, { list: { enum: -> { Campaign::SPECIAL_AD_CATEGORY_COUNTRY }} }
         api.has_param :spend_cap, 'int'
         api.has_param :status, { enum: -> { Campaign::STATUS }}
         api.has_param :topline_id, 'string'
@@ -716,6 +706,14 @@ module FacebookAds
       end
     end
 
+    has_edge :create_and_apply_publisher_block_list do |edge|
+      edge.post do |api|
+        api.has_param :is_auto_blocking_on, 'bool'
+        api.has_param :name, 'string'
+        api.has_param :publisher_urls, { list: 'string' }
+      end
+    end
+
     has_edge :customaudiences do |edge|
       edge.get 'CustomAudience' do |api|
         api.has_param :business_id, 'string'

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -26,10 +26,33 @@ module FacebookAds
   # pull request for this class.
 
   class AdAccountAdVolume < AdObject
+    RECOMMENDATION_TYPE = [
+      "AGGREGATED_BID_LIMITED",
+      "AGGREGATED_BUDGET_LIMITED",
+      "AGGREGATED_COST_LIMITED",
+      "AUCTION_OVERLAP",
+      "CREATIVE_FATIGUE",
+      "FRAGMENTATION",
+      "LEARNING_LIMITED",
+      "TOP_ADSETS_WITH_ADS_UNDER_CAP",
+      "TOP_CAMPAIGNS_WITH_ADS_UNDER_CAP",
+      "UNECONOMICAL_ADS_THROTTLING",
+      "ZERO_IMPRESSION",
+    ]
+
 
     field :actor_id, 'string'
+    field :actor_name, 'string'
+    field :ad_limit_scope_business, 'Business'
+    field :ad_limit_scope_business_manager_id, 'string'
+    field :ad_limit_set_by_page_admin, 'int'
     field :ads_running_or_in_review_count, 'int'
+    field :ads_running_or_in_review_count_subject_to_limit_set_by_page, 'int'
     field :current_account_ads_running_or_in_review_count, 'int'
+    field :future_limit_activation_date, 'string'
+    field :future_limit_on_ads_running_or_in_review, 'int'
+    field :limit_on_ads_running_or_in_review, 'int'
+    field :recommendations, { list: 'object' }
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_account_creation_request.rb

@@ -47,7 +47,6 @@ module FacebookAds
     field :id, 'string'
     field :is_smb, 'bool'
     field :is_test, 'bool'
-    field :is_under_authorization, 'bool'
     field :legal_entity_name_in_local_language, 'string'
     field :oe_request_id, 'string'
     field :official_website_url, 'string'

data/lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb

@@ -45,6 +45,7 @@ module FacebookAds
       "PAGE_ENGAGEMENT",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
+      "QUALITY_LEAD",
       "REACH",
       "REPLIES",
       "SOCIAL_IMPRESSIONS",

data/lib/facebook_ads/ad_objects/ad_account_matched_search_applications_edge_data.rb

@@ -36,6 +36,7 @@ module FacebookAds
       "INSTANT_GAME",
       "ITUNES",
       "ITUNES_IPAD",
+      "OCULUS_APP_STORE",
       "ROKU_STORE",
       "WINDOWS_10_STORE",
       "WINDOWS_STORE",

data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb

@@ -59,6 +59,7 @@ module FacebookAds
       "CREDIT",
       "EMPLOYMENT",
       "HOUSING",
+      "ISSUES_ELECTIONS_POLITICS",
       "NONE",
     ]
 
@@ -134,6 +135,7 @@ module FacebookAds
       "industries",
       "instagram_hashtags",
       "instagram_positions",
+      "instream_video_skippable_excluded",
       "instream_video_sponsorship_placements",
       "interest_defaults_source",
       "interested_in",
@@ -204,6 +206,7 @@ module FacebookAds
       "POST_ENGAGEMENT",
       "PRODUCT_CATALOG_SALES",
       "REACH",
+      "STORE_VISITS",
       "VIDEO_VIEWS",
     ]
 

data/lib/facebook_ads/ad_objects/ad_activity.rb

@@ -82,6 +82,7 @@ module FacebookAds
       "update_ad_set_bidding",
       "update_ad_set_budget",
       "update_ad_set_duration",
+      "update_ad_set_learning_stage_status",
       "update_ad_set_min_spend_target",
       "update_ad_set_name",
       "update_ad_set_optimization_goal",
@@ -93,6 +94,7 @@ module FacebookAds
       "update_audience",
       "update_campaign_ad_scheduling",
       "update_campaign_budget",
+      "update_campaign_budget_optimization_toggling_status",
       "update_campaign_delivery_type",
       "update_campaign_duration",
       "update_campaign_group_ad_scheduling",
@@ -101,6 +103,7 @@ module FacebookAds
       "update_campaign_name",
       "update_campaign_run_status",
       "update_campaign_schedule",
+      "update_delivery_type_cross_level_shift",
     ]
 
     CATEGORY = [
@@ -117,6 +120,11 @@ module FacebookAds
       "TARGETING",
     ]
 
+    DATA_SOURCE = [
+      "CALYPSO",
+      "TAO",
+    ]
+
 
     field :actor_id, 'string'
     field :actor_name, 'string'

data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb

@@ -44,6 +44,7 @@ module FacebookAds
       "FIND_A_GROUP",
       "FIND_YOUR_GROUPS",
       "FOLLOW_NEWS_STORYLINE",
+      "FOLLOW_PAGE",
       "FOLLOW_USER",
       "GET_DIRECTIONS",
       "GET_OFFER",
@@ -70,6 +71,7 @@ module FacebookAds
       "SAY_THANKS",
       "SEE_MORE",
       "SELL_NOW",
+      "SEND_A_GIFT",
       "SHARE",
       "SHOP_NOW",
       "SIGN_UP",
@@ -101,6 +103,7 @@ module FacebookAds
     field :images, { list: 'AdAssetFeedSpecImage' }
     field :link_urls, { list: 'AdAssetFeedSpecLinkUrl' }
     field :optimization_type, 'string'
+    field :posts, { list: 'object' }
     field :titles, { list: 'AdAssetFeedSpecTitle' }
     field :videos, { list: 'AdAssetFeedSpecVideo' }
     has_no_id

data/lib/facebook_ads/ad_objects/ad_campaign_activity.rb

@@ -83,6 +83,7 @@ module FacebookAds
       "PAGE_ENGAGEMENT",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
+      "QUALITY_LEAD",
       "REACH",
       "REPLIES",
       "SOCIAL_IMPRESSIONS",
@@ -111,6 +112,7 @@ module FacebookAds
       "PAGE_ENGAGEMENT",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
+      "QUALITY_LEAD",
       "REACH",
       "REPLIES",
       "SOCIAL_IMPRESSIONS",
@@ -137,8 +139,6 @@ module FacebookAds
     field :bid_type_old, 'string'
     field :billing_event_new, { enum: -> { BILLING_EVENT_NEW }}
     field :billing_event_old, { enum: -> { BILLING_EVENT_OLD }}
-    field :brande_audience_id_new, 'BrandAudience'
-    field :brande_audience_id_old, 'BrandAudience'
     field :budget_limit_new, 'object'
     field :budget_limit_old, 'object'
     field :created_time, 'datetime'

data/lib/facebook_ads/ad_objects/ad_campaign_delivery_estimate.rb

@@ -45,6 +45,7 @@ module FacebookAds
       "PAGE_ENGAGEMENT",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
+      "QUALITY_LEAD",
       "REACH",
       "REPLIES",
       "SOCIAL_IMPRESSIONS",

data/lib/facebook_ads/ad_objects/ad_creative.rb

@@ -50,6 +50,7 @@ module FacebookAds
       "FIND_A_GROUP",
       "FIND_YOUR_GROUPS",
       "FOLLOW_NEWS_STORYLINE",
+      "FOLLOW_PAGE",
       "FOLLOW_USER",
       "GET_DIRECTIONS",
       "GET_OFFER",
@@ -76,6 +77,7 @@ module FacebookAds
       "SAY_THANKS",
       "SEE_MORE",
       "SELL_NOW",
+      "SEND_A_GIFT",
       "SHARE",
       "SHOP_NOW",
       "SIGN_UP",
@@ -210,9 +212,6 @@ module FacebookAds
     field :is_dco_internal, 'bool'
 
     has_edge :adlabels do |edge|
-      edge.delete do |api|
-        api.has_param :adlabels, { list: 'object' }
-      end
       edge.post 'AdCreative' do |api|
         api.has_param :adlabels, { list: 'object' }
       end

data/lib/facebook_ads/ad_objects/{atlas_url.rb → ad_creative_instagram_branded_content.rb}

@@ -25,9 +25,8 @@ module FacebookAds
   # on github and we'll fix in our codegen framework. We'll not be able to accept
   # pull request for this class.
 
-  class AtlasUrl < AdObject
+  class AdCreativeInstagramBrandedContent < AdObject
 
-    field :url, 'string'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_creative_interactive_components_spec.rb

@@ -27,6 +27,7 @@ module FacebookAds
 
   class AdCreativeInteractiveComponentsSpec < AdObject
 
+    field :child_attachments, { list: 'object' }
     field :components, { list: 'object' }
     has_no_id
     has_no_get

data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb

@@ -44,6 +44,7 @@ module FacebookAds
       "FIND_A_GROUP",
       "FIND_YOUR_GROUPS",
       "FOLLOW_NEWS_STORYLINE",
+      "FOLLOW_PAGE",
       "FOLLOW_USER",
       "GET_DIRECTIONS",
       "GET_OFFER",
@@ -70,6 +71,7 @@ module FacebookAds
       "SAY_THANKS",
       "SEE_MORE",
       "SELL_NOW",
+      "SEND_A_GIFT",
       "SHARE",
       "SHOP_NOW",
       "SIGN_UP",

data/lib/facebook_ads/ad_objects/ad_network_analytics_sync_query_result.rb

@@ -32,6 +32,7 @@ module FacebookAds
     ]
 
     BREAKDOWNS = [
+      "AD_SERVER_CAMPAIGN_ID",
       "AD_SPACE",
       "AGE",
       "APP",
@@ -46,6 +47,7 @@ module FacebookAds
       "GENDER",
       "INSTANT_ARTICLE_ID",
       "INSTANT_ARTICLE_PAGE_ID",
+      "IS_DEAL_BACKFILL",
       "PLACEMENT",
       "PLACEMENT_NAME",
       "PLATFORM",

data/lib/facebook_ads/ad_objects/ad_place_page_set.rb

@@ -26,6 +26,11 @@ module FacebookAds
   # pull request for this class.
 
   class AdPlacePageSet < AdObject
+    CATEGORY = [
+      "BOPUS",
+      "GENERAL",
+    ]
+
     LOCATION_TYPES = [
       "home",
       "recent",
@@ -44,6 +49,7 @@ module FacebookAds
     field :name, 'string'
     field :pages_count, 'int'
     field :parent_page, 'Page'
+    field :category, 'adaccountad_place_page_sets_category_enum_param'
     field :targeted_area_type, 'adaccountad_place_page_sets_targeted_area_type_enum_param'
     has_no_post
     has_no_delete

data/lib/facebook_ads/ad_objects/ad_preview.rb

@@ -40,6 +40,7 @@ module FacebookAds
       "INSTANT_ARTICLE_RECIRCULATION_AD",
       "INSTANT_ARTICLE_STANDARD",
       "INSTREAM_VIDEO_DESKTOP",
+      "INSTREAM_VIDEO_IMAGE",
       "INSTREAM_VIDEO_MOBILE",
       "JOB_BROWSER_DESKTOP",
       "JOB_BROWSER_MOBILE",

data/lib/facebook_ads/ad_objects/ad_report_spec.rb

@@ -38,7 +38,6 @@ module FacebookAds
     field :id, 'string'
     field :insights_section, 'object'
     field :name, 'string'
-    field :report_schedule, 'object'
     field :report_schedule_id, 'string'
     field :sort_by, 'string'
     field :sort_dir, 'string'

data/lib/facebook_ads/ad_objects/ad_set.rb

@@ -81,6 +81,7 @@ module FacebookAds
       "PAGE_ENGAGEMENT",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
+      "QUALITY_LEAD",
       "REACH",
       "REPLIES",
       "SOCIAL_IMPRESSIONS",
@@ -163,6 +164,7 @@ module FacebookAds
       "CREDIT",
       "EMPLOYMENT",
       "HOUSING",
+      "ISSUES_ELECTIONS_POLITICS",
       "NONE",
     ]