facebookbusiness 0.8.0.0 → 0.9.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4de6bfc476d804de39cce9ae238d8d4d974c1019c255eb244130636474a569d0
-  data.tar.gz: 74f7adab3e79333ade1467585d83c98c564c2eb92a532d199049c42effc32553
+  metadata.gz: 37ca4f8749f72bc1cd7eba12b4bcd07c4d4621e95efd3f028e21982037c378e7
+  data.tar.gz: e532f62cf2f842d6a18bc3916aa07bd3799fa4ca2979df9ea3e8362168893cb9
 SHA512:
-  metadata.gz: 310be0ab8c3fa0f1c0d3ce31e5b1734e306d1cd4daa92a78b80873106552216909d52d63c11a1899192c8b3df36a400cc42900563e2dce81dc6eb0b6c17636d7
-  data.tar.gz: 4b4bbdb344b3c66a2d31462139b3c18d63ba5be074d943456ebe461dd4a0b3e467ce5bbf3f17fe9b3a5034fec226640987e766b2f0f8c12c68a7ea4ffbdffcee
+  metadata.gz: 7fb8c27d58ddd9e18a5304adb7ce70031e3e5d1c8c0c3c0d8f09dbf1cd84a6e8a33ea45e2d9c8bc5191bc2fe4b389ecaab36b090855252cbe3e2b95bc66256ac
+  data.tar.gz: 3985f549327ac4d822b6614f6555815f0586ebfae93d2657c42919bf4a04ccd11d5eed5040491b436bee186cf279d76af96f87b2e3618349ecf0ba39ec5c7210

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -268,6 +268,7 @@ module FacebookAds
         api.has_param :image_url, 'string'
         api.has_param :instagram_actor_id, 'string'
         api.has_param :instagram_permalink_url, 'string'
+        api.has_param :instagram_user_id, 'string'
         api.has_param :instant_checkout_setting, { enum: -> { AdCreative::INSTANT_CHECKOUT_SETTING }}
         api.has_param :interactive_components_spec, 'hash'
         api.has_param :is_dco_internal, 'bool'
@@ -285,6 +286,7 @@ module FacebookAds
         api.has_param :portrait_customizations, 'hash'
         api.has_param :product_set_id, 'string'
         api.has_param :recommender_settings, 'hash'
+        api.has_param :source_instagram_media_id, 'string'
         api.has_param :template_url, 'string'
         api.has_param :template_url_spec, 'object'
         api.has_param :thumbnail_url, 'string'
@@ -332,6 +334,7 @@ module FacebookAds
       edge.post 'PlayableContent' do |api|
         api.has_param :app_id, 'string'
         api.has_param :name, 'string'
+        api.has_param :session_id, 'string'
         api.has_param :source, 'file'
         api.has_param :source_url, 'string'
         api.has_param :source_zip, 'file'
@@ -391,6 +394,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
@@ -554,6 +558,7 @@ module FacebookAds
         api.has_param :sales_promo_id, 'int'
         api.has_param :slideshow_spec, 'hash'
         api.has_param :source, 'file'
+        api.has_param :source_instagram_media_id, 'string'
         api.has_param :spherical, 'bool'
         api.has_param :start_offset, 'int'
         api.has_param :swap_mode, { enum: -> { AdVideo::SWAP_MODE }}
@@ -677,6 +682,7 @@ module FacebookAds
         api.has_param :objective, { enum: -> { Campaign::OBJECTIVE }}
         api.has_param :pacing_type, { list: 'string' }
         api.has_param :promoted_object, 'object'
+        api.has_param :smart_promotion_type, { enum: -> { Campaign::SMART_PROMOTION_TYPE }}
         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 }} }
@@ -694,6 +700,10 @@ module FacebookAds
       end
     end
 
+    has_edge :connected_instagram_accounts do |edge|
+      edge.get 'IgUser'
+    end
+
     has_edge :content_delivery_report do |edge|
       edge.get 'ContentDeliveryReport' do |api|
         api.has_param :end_date, 'datetime'
@@ -705,6 +715,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'
@@ -1047,9 +1065,12 @@ module FacebookAds
     has_edge :targetingsearch do |edge|
       edge.get 'AdAccountTargetingUnified' do |api|
         api.has_param :allow_only_fat_head_interests, 'bool'
+        api.has_param :app_store, { enum: -> { AdAccountTargetingUnified::APP_STORE }}
         api.has_param :countries, { list: 'string' }
         api.has_param :is_exclusion, 'bool'
         api.has_param :limit_type, { enum: -> { AdAccountTargetingUnified::LIMIT_TYPE }}
+        api.has_param :objective, { enum: -> { AdAccountTargetingUnified::OBJECTIVE }}
+        api.has_param :promoted_object, 'object'
         api.has_param :q, 'string'
         api.has_param :regulated_categories, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_CATEGORIES }} }
         api.has_param :session_id, 'int'
@@ -1069,6 +1090,7 @@ module FacebookAds
 
     has_edge :targetingsuggestions do |edge|
       edge.get 'AdAccountTargetingUnified' do |api|
+        api.has_param :app_store, { enum: -> { AdAccountTargetingUnified::APP_STORE }}
         api.has_param :countries, { list: 'string' }
         api.has_param :limit_type, { enum: -> { AdAccountTargetingUnified::LIMIT_TYPE }}
         api.has_param :mode, { enum: -> { AdAccountTargetingUnified::MODE }}
@@ -1091,9 +1113,6 @@ module FacebookAds
     end
 
     has_edge :tracking do |edge|
-      edge.delete do |api|
-        api.has_param :tracking_specs, 'object'
-      end
       edge.get 'AdAccountTrackingData'
       edge.post 'AdAccount' do |api|
         api.has_param :tracking_specs, 'object'

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -26,10 +26,34 @@ module FacebookAds
   # pull request for this class.
 
   class AdAccountAdVolume < AdObject
+    RECOMMENDATION_TYPE = [
+      "ACO_TOGGLE",
+      "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_targeting_unified.rb

@@ -185,11 +185,20 @@ module FacebookAds
       "zips",
     ]
 
-    MODE = [
-      "best_performing",
-      "recently_used",
-      "related",
-      "suggestions",
+    APP_STORE = [
+      "amazon_app_store",
+      "does_not_exist",
+      "fb_android_store",
+      "fb_canvas",
+      "fb_gameroom",
+      "google_play",
+      "instant_game",
+      "itunes",
+      "itunes_ipad",
+      "oculus_app_store",
+      "roku_channel_store",
+      "windows_10_store",
+      "windows_store",
     ]
 
     OBJECTIVE = [
@@ -202,6 +211,7 @@ module FacebookAds
       "LOCAL_AWARENESS",
       "MESSAGES",
       "OFFER_CLAIMS",
+      "OUTCOME_LEADS",
       "PAGE_LIKES",
       "POST_ENGAGEMENT",
       "PRODUCT_CATALOG_SALES",
@@ -210,6 +220,13 @@ module FacebookAds
       "VIDEO_VIEWS",
     ]
 
+    MODE = [
+      "best_performing",
+      "recently_used",
+      "related",
+      "suggestions",
+    ]
+
 
     field :audience_size, 'int'
     field :conversion_lift, 'double'

data/lib/facebook_ads/ad_objects/ad_activity.rb

@@ -96,7 +96,6 @@ module FacebookAds
       "update_campaign_budget",
       "update_campaign_budget_optimization_toggling_status",
       "update_campaign_delivery_type",
-      "update_campaign_duration",
       "update_campaign_group_ad_scheduling",
       "update_campaign_group_delivery_type",
       "update_campaign_group_spend_cap",

data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb

@@ -67,6 +67,7 @@ module FacebookAds
       "PLAY_GAME",
       "PURCHASE_GIFT_CARDS",
       "RECORD_NOW",
+      "REFER_FRIENDS",
       "REQUEST_TIME",
       "SAY_THANKS",
       "SEE_MORE",
@@ -76,7 +77,10 @@ module FacebookAds
       "SHOP_NOW",
       "SIGN_UP",
       "SOTTO_SUBSCRIBE",
+      "START_ORDER",
       "SUBSCRIBE",
+      "SWIPE_UP_PRODUCT",
+      "SWIPE_UP_SHOP",
       "UPDATE_APP",
       "USE_APP",
       "USE_MOBILE_APP",
@@ -103,6 +107,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_async_request.rb

@@ -35,6 +35,8 @@ module FacebookAds
       "INITIAL",
       "IN_PROGRESS",
       "PENDING_DEPENDENCY",
+      "PROCESS_BY_AD_ASYNC_ENGINE",
+      "PROCESS_BY_EVENT_PROCESSOR",
       "SUCCESS",
       "USER_CANCELED",
       "USER_CANCELED_DEPENDENCY",

data/lib/facebook_ads/ad_objects/ad_campaign_activity.rb

@@ -163,6 +163,8 @@ module FacebookAds
     field :optimization_goal_old, { enum: -> { OPTIMIZATION_GOAL_OLD }}
     field :pacing_type_new, 'int'
     field :pacing_type_old, 'int'
+    field :promoted_object_id_new, 'string'
+    field :promoted_object_id_old, 'string'
     field :run_status_new, 'string'
     field :run_status_old, 'string'
     field :schedule_new, { list: 'object' }
@@ -175,6 +177,8 @@ module FacebookAds
     field :stop_time_old, 'datetime'
     field :targeting_expansion_new, 'object'
     field :targeting_expansion_old, 'object'
+    field :targeting_new, 'object'
+    field :targeting_old, 'object'
     field :updated_time_new, 'datetime'
     field :updated_time_old, 'datetime'
     has_no_post

data/lib/facebook_ads/ad_objects/ad_creative.rb

@@ -73,6 +73,7 @@ module FacebookAds
       "PLAY_GAME",
       "PURCHASE_GIFT_CARDS",
       "RECORD_NOW",
+      "REFER_FRIENDS",
       "REQUEST_TIME",
       "SAY_THANKS",
       "SEE_MORE",
@@ -82,7 +83,10 @@ module FacebookAds
       "SHOP_NOW",
       "SIGN_UP",
       "SOTTO_SUBSCRIBE",
+      "START_ORDER",
       "SUBSCRIBE",
+      "SWIPE_UP_PRODUCT",
+      "SWIPE_UP_SHOP",
       "UPDATE_APP",
       "USE_APP",
       "USE_MOBILE_APP",
@@ -179,6 +183,7 @@ module FacebookAds
     field :instagram_actor_id, 'string'
     field :instagram_permalink_url, 'string'
     field :instagram_story_id, 'string'
+    field :instagram_user_id, 'string'
     field :interactive_components_spec, 'AdCreativeInteractiveComponentsSpec'
     field :link_deep_link_url, 'string'
     field :link_destination_display_url, 'string'
@@ -198,6 +203,7 @@ module FacebookAds
     field :portrait_customizations, 'AdCreativePortraitCustomizations'
     field :product_set_id, 'string'
     field :recommender_settings, 'AdCreativeRecommenderSettings'
+    field :source_instagram_media_id, 'string'
     field :status, { enum: -> { STATUS }}
     field :template_url, 'string'
     field :template_url_spec, 'AdCreativeTemplateUrlSpec'

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

@@ -67,6 +67,7 @@ module FacebookAds
       "PLAY_GAME",
       "PURCHASE_GIFT_CARDS",
       "RECORD_NOW",
+      "REFER_FRIENDS",
       "REQUEST_TIME",
       "SAY_THANKS",
       "SEE_MORE",
@@ -76,7 +77,10 @@ module FacebookAds
       "SHOP_NOW",
       "SIGN_UP",
       "SOTTO_SUBSCRIBE",
+      "START_ORDER",
       "SUBSCRIBE",
+      "SWIPE_UP_PRODUCT",
+      "SWIPE_UP_SHOP",
       "UPDATE_APP",
       "USE_APP",
       "USE_MOBILE_APP",

data/lib/facebook_ads/ad_objects/ad_network_analytics_sync_query_result.rb

@@ -47,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_preview.rb

@@ -57,6 +57,7 @@ module FacebookAds
       "RIGHT_COLUMN_STANDARD",
       "SUGGESTED_VIDEO_DESKTOP",
       "SUGGESTED_VIDEO_MOBILE",
+      "WATCH_FEED_HOME",
       "WATCH_FEED_MOBILE",
     ]
 

data/lib/facebook_ads/ad_objects/ad_rule_execution_spec.rb

@@ -27,15 +27,19 @@ module FacebookAds
 
   class AdRuleExecutionSpec < AdObject
     EXECUTION_TYPE = [
+      "ADD_INTEREST_RELAXATION",
+      "ADD_QUESTIONNAIRE_INTERESTS",
       "CHANGE_BID",
       "CHANGE_BUDGET",
       "CHANGE_CAMPAIGN_BUDGET",
+      "INCREASE_RADIUS",
       "NOTIFICATION",
       "PAUSE",
       "PING_ENDPOINT",
       "REBALANCE_BUDGET",
       "ROTATE",
       "UNPAUSE",
+      "UPDATE_CREATIVE",
     ]
 
 

data/lib/facebook_ads/ad_objects/ad_study.rb

@@ -30,6 +30,7 @@ module FacebookAds
       "CONTINUOUS_LIFT_CONFIG",
       "GEO_LIFT",
       "LIFT",
+      "PRIVATE_LIFT",
       "SPLIT_TEST",
     ]
 
@@ -68,7 +69,6 @@ module FacebookAds
         api.has_param :is_primary, 'bool'
         api.has_param :name, 'string'
         api.has_param :offline_conversion_data_sets, { list: 'object' }
-        api.has_param :offsitepixels, { list: 'object' }
         api.has_param :product_catalogs, { list: 'object' }
         api.has_param :product_sets, { list: 'object' }
         api.has_param :type, { enum: -> { AdStudyObjective::TYPE }}

data/lib/facebook_ads/ad_objects/ad_study_objective.rb

@@ -66,10 +66,6 @@ module FacebookAds
       edge.get 'OfflineConversionDataSet'
     end
 
-    has_edge :offsitepixels do |edge|
-      edge.get 'OffsitePixel'
-    end
-
     has_edge :partnerstudies do |edge|
       edge.get 'PartnerStudy'
     end

data/lib/facebook_ads/ad_objects/ad_video.rb

@@ -43,6 +43,7 @@ module FacebookAds
       "CANDIDATE_VIDEOS",
       "CANVAS",
       "CFC_VIDEO",
+      "CMS_MEDIA_MANAGER",
       "CONTAINED_POST_ATTACHMENT",
       "CONTAINED_POST_AUDIO_BROADCAST",
       "CONTAINED_POST_BROADCAST",
@@ -77,6 +78,7 @@ module FacebookAds
       "HEURISTIC_CLUSTER_VIDEO",
       "HEURISTIC_PREVIEW",
       "HIGHLIGHT_CLIP_VIDEO",
+      "IG_REELS_XPV",
       "IG_STORIES_READER",
       "INSPIRATION_VIDEO",
       "INSTAGRAM_VIDEO_COPY",
@@ -129,12 +131,14 @@ module FacebookAds
       "STORYLINE_WITH_EXTERNAL_MUSIC",
       "STORY_ARCHIVE_VIDEO",
       "STORY_CARD_TEMPLATE",
+      "STREAM_HIGHLIGHTS_VIDEO",
       "TAROT_DIGEST",
       "TEMP_MULTIMEDIA_POST",
       "UNLISTED",
       "VIDEO_COMMENT",
       "VIDEO_CREATIVE_EDITOR_AUTOGEN_AD_VIDEO",
       "VIDEO_SUPERRES",
+      "VU_GENERATED_VIDEO",
       "WOODHENGE",
       "WORK_KNOWLEDGE_VIDEO",
       "YOUR_DAY",
@@ -300,6 +304,7 @@ module FacebookAds
     field :replace_video_id, 'string'
     field :sales_promo_id, 'int'
     field :slideshow_spec, 'hash'
+    field :source_instagram_media_id, 'string'
     field :start_offset, 'int'
     field :swap_mode, { enum: -> { SWAP_MODE }}
     field :text_format_metadata, 'string'
@@ -380,6 +385,12 @@ module FacebookAds
       end
     end
 
+    has_edge :reactions do |edge|
+      edge.get 'Profile' do |api|
+        api.has_param :type, { enum: -> { Profile::TYPE }}
+      end
+    end
+
     has_edge :sharedposts do |edge|
       edge.get 'Post'
     end

data/lib/facebook_ads/ad_objects/adgroup_activity.rb

@@ -113,6 +113,8 @@ module FacebookAds
     field :stop_time_old, 'datetime'
     field :target_spec_id_new, 'string'
     field :target_spec_id_old, 'string'
+    field :targets_spec_new, 'object'
+    field :targets_spec_old, 'object'
     field :tracking_pixel_ids_new, { list: 'string' }
     field :tracking_pixel_ids_old, { list: 'string' }
     field :tracking_specs_new, { list: 'object' }