facebookbusiness 0.12.0.1 → 21.0.0

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -1,20 +1,8 @@
-# Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
-#
-# You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
-# copy, modify, and distribute this software in source code or binary form for use
-# in connection with the web services and APIs provided by Facebook.
-#
-# As with any software that integrates with the Facebook platform, your use of
-# this software is subject to the Facebook Platform Policy
-# [http://developers.facebook.com/policy/]. This copyright notice shall be
-# included in all copies or substantial portions of the software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
-# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+# All rights reserved.
+
+# This source code is licensed under the license found in the
+# LICENSE file in the root directory of this source tree.
 
 # FB:AUTOGEN
 
@@ -56,6 +44,7 @@ module FacebookAds
       "JPY",
       "KES",
       "KRW",
+      "LKR",
       "MOP",
       "MXN",
       "MYR",
@@ -70,7 +59,6 @@ module FacebookAds
       "PYG",
       "QAR",
       "RON",
-      "RUB",
       "SAR",
       "SEK",
       "SGD",
@@ -84,6 +72,14 @@ module FacebookAds
       "ZAR",
     ]
 
+    PERMITTED_TASKS = [
+      "AA_ANALYZE",
+      "ADVERTISE",
+      "ANALYZE",
+      "DRAFT",
+      "MANAGE",
+    ]
+
     TASKS = [
       "AA_ANALYZE",
       "ADVERTISE",
@@ -92,6 +88,21 @@ module FacebookAds
       "MANAGE",
     ]
 
+    BRAND_SAFETY_CONTENT_FILTER_LEVELS = [
+      "AN_RELAXED",
+      "AN_STANDARD",
+      "AN_STRICT",
+      "FACEBOOK_RELAXED",
+      "FACEBOOK_STANDARD",
+      "FACEBOOK_STRICT",
+      "FEED_DNM",
+      "FEED_RELAXED",
+      "FEED_STANDARD",
+      "FEED_STRICT",
+      "UNINITIALIZED",
+      "UNKNOWN",
+    ]
+
     CLAIM_OBJECTIVE = [
       "AUTOMOTIVE_MODEL",
       "COLLABORATIVE_ADS",
@@ -107,11 +118,11 @@ module FacebookAds
       "AUTOMOTIVE_MODEL",
       "DESTINATION",
       "FLIGHT",
+      "GENERIC",
       "HOME_LISTING",
       "HOTEL",
       "JOB",
       "LOCAL_SERVICE_BUSINESS",
-      "LOCATION_BASED_ITEM",
       "MEDIA_TITLE",
       "OFFLINE_PRODUCT",
       "PRODUCT",
@@ -122,30 +133,42 @@ module FacebookAds
     SUBTYPE = [
       "APP",
       "BAG_OF_ACCOUNTS",
+      "BIDDING",
       "CLAIM",
       "CUSTOM",
       "ENGAGEMENT",
+      "EXCLUSION",
       "FOX",
       "LOOKALIKE",
       "MANAGED",
       "MEASUREMENT",
+      "MESSENGER_SUBSCRIBER_LIST",
       "OFFLINE_CONVERSION",
       "PARTNER",
+      "PRIMARY",
       "REGULATED_CATEGORIES_AUDIENCE",
       "STUDY_RULE_AUDIENCE",
+      "SUBSCRIBER_SEGMENT",
       "VIDEO",
       "WEBSITE",
     ]
 
+    ACTION_SOURCE = [
+      "PHYSICAL_STORE",
+      "WEBSITE",
+    ]
+
 
     field :account_id, 'string'
     field :account_status, 'int'
     field :ad_account_promotable_objects, 'AdAccountPromotableObjects'
     field :age, 'double'
     field :agency_client_declaration, 'AgencyClientDeclaration'
+    field :all_capabilities, { list: 'string' }
     field :amount_spent, 'string'
     field :attribution_spec, { list: 'AttributionSpec' }
     field :balance, 'string'
+    field :brand_safety_content_filter_levels, { list: 'string' }
     field :business, 'Business'
     field :business_city, 'string'
     field :business_country_code, 'string'
@@ -158,6 +181,9 @@ module FacebookAds
     field :capabilities, { list: 'string' }
     field :created_time, 'datetime'
     field :currency, 'string'
+    field :custom_audience_info, 'CustomAudienceGroup'
+    field :default_dsa_beneficiary, 'string'
+    field :default_dsa_payor, 'string'
     field :disable_reason, 'int'
     field :end_advertiser, 'string'
     field :end_advertiser_name, 'string'
@@ -167,7 +193,6 @@ module FacebookAds
     field :fb_entity, 'int'
     field :funding_source, 'string'
     field :funding_source_details, 'FundingSourceDetails'
-    field :has_advertiser_opted_in_odax, 'bool'
     field :has_migrated_permissions, 'bool'
     field :has_page_authorized_adaccount, 'bool'
     field :id, 'string'
@@ -179,6 +204,7 @@ module FacebookAds
     field :is_personal, 'int'
     field :is_prepay_account, 'bool'
     field :is_tax_id_required, 'bool'
+    field :liable_address, 'CrmAddress'
     field :line_numbers, { list: 'int' }
     field :media_agency, 'string'
     field :min_campaign_group_spend_cap, 'string'
@@ -186,9 +212,12 @@ module FacebookAds
     field :name, 'string'
     field :offsite_pixels_tos_accepted, 'bool'
     field :owner, 'string'
+    field :owner_business, 'Business'
     field :partner, 'string'
     field :rf_spec, 'ReachFrequencySpec'
+    field :send_bill_to_address, 'CrmAddress'
     field :show_checkout_experience, 'bool'
+    field :sold_to_address, 'CrmAddress'
     field :spend_cap, 'string'
     field :tax_id, 'string'
     field :tax_id_status, 'int'
@@ -197,10 +226,20 @@ module FacebookAds
     field :timezone_name, 'string'
     field :timezone_offset_hours_utc, 'double'
     field :tos_accepted, 'hash'
+    field :user_access_expire_time, 'datetime'
     field :user_tasks, { list: 'string' }
     field :user_tos_accepted, 'hash'
+    field :viewable_business, 'Business'
     has_no_delete
 
+    has_edge :account_controls do |edge|
+      edge.get 'AdAccountBusinessConstraints'
+      edge.post 'AdAccountBusinessConstraints' do |api|
+        api.has_param :audience_controls, 'object'
+        api.has_param :placement_controls, 'object'
+      end
+    end
+
     has_edge :activities do |edge|
       edge.get 'AdActivity' do |api|
         api.has_param :add_children, 'bool'
@@ -237,7 +276,7 @@ module FacebookAds
     end
 
     has_edge :ad_saved_keywords do |edge|
-      edge.get do |api|
+      edge.get 'AdSavedKeywords' do |api|
         api.has_param :fields, { list: 'string' }
       end
     end
@@ -259,33 +298,38 @@ module FacebookAds
         api.has_param :asset_feed_spec, 'object'
         api.has_param :authorization_category, { enum: -> { AdCreative::AUTHORIZATION_CATEGORY }}
         api.has_param :body, 'string'
+        api.has_param :branded_content, 'hash'
         api.has_param :branded_content_sponsor_page_id, 'string'
         api.has_param :bundle_folder_id, 'string'
         api.has_param :call_to_action, 'object'
         api.has_param :categorization_criteria, { enum: -> { AdCreative::CATEGORIZATION_CRITERIA }}
         api.has_param :category_media_source, { enum: -> { AdCreative::CATEGORY_MEDIA_SOURCE }}
+        api.has_param :contextual_multi_ads, 'hash'
+        api.has_param :degrees_of_freedom_spec, 'hash'
         api.has_param :destination_set_id, 'string'
         api.has_param :dynamic_ad_voice, { enum: -> { AdCreative::DYNAMIC_AD_VOICE }}
         api.has_param :enable_launch_instant_app, 'bool'
+        api.has_param :facebook_branded_content, 'hash'
         api.has_param :image_crops, 'hash'
         api.has_param :image_file, 'string'
         api.has_param :image_hash, 'string'
         api.has_param :image_url, 'string'
         api.has_param :instagram_actor_id, 'string'
+        api.has_param :instagram_branded_content, 'hash'
         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'
         api.has_param :link_og_id, 'string'
         api.has_param :link_url, 'string'
-        api.has_param :messenger_sponsored_message, 'string'
         api.has_param :name, 'string'
         api.has_param :object_id, 'int'
         api.has_param :object_story_id, 'string'
         api.has_param :object_story_spec, 'AdCreativeObjectStorySpec'
         api.has_param :object_type, 'string'
         api.has_param :object_url, 'string'
+        api.has_param :omnichannel_link_spec, 'hash'
+        api.has_param :page_welcome_message, 'string'
         api.has_param :place_page_set_id, 'string'
         api.has_param :platform_customizations, 'object'
         api.has_param :playable_asset_id, 'string'
@@ -294,7 +338,7 @@ module FacebookAds
         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 :template_url_spec, 'string'
         api.has_param :thumbnail_url, 'string'
         api.has_param :title, 'string'
         api.has_param :url_tags, 'string'
@@ -320,9 +364,10 @@ module FacebookAds
         api.has_param :minheight, 'int'
         api.has_param :minwidth, 'int'
         api.has_param :name, 'string'
+        api.has_param :selected_hashes, { list: 'string' }
       end
       edge.post list: 'AdImage' do |api|
-        api.has_param :bytes, 'object'
+        api.has_param :bytes, 'string'
         api.has_param :copy_from, 'object'
         api.accepts_files!
       end
@@ -336,8 +381,8 @@ module FacebookAds
     end
 
     has_edge :adplayables do |edge|
-      edge.get
-      edge.post do |api|
+      edge.get 'PlayableContent'
+      edge.post 'PlayableContent' do |api|
         api.has_param :app_id, 'string'
         api.has_param :name, 'string'
         api.has_param :session_id, 'string'
@@ -373,10 +418,12 @@ module FacebookAds
       edge.get 'Ad' do |api|
         api.has_param :date_preset, { enum: -> { Ad::DATE_PRESET }}
         api.has_param :effective_status, { list: 'string' }
-        api.has_param :time_range, 'object'
+        api.has_param :time_range, 'hash'
         api.has_param :updated_since, 'int'
       end
       edge.post 'Ad' do |api|
+        api.has_param :ad_schedule_end_time, 'datetime'
+        api.has_param :ad_schedule_start_time, 'datetime'
         api.has_param :adlabels, { list: 'object' }
         api.has_param :adset_id, 'int'
         api.has_param :adset_spec, 'AdSet'
@@ -384,6 +431,7 @@ module FacebookAds
         api.has_param :bid_amount, 'int'
         api.has_param :conversion_domain, 'string'
         api.has_param :creative, 'AdCreative'
+        api.has_param :creative_asset_groups_spec, 'object'
         api.has_param :date_format, 'string'
         api.has_param :display_sequence, 'int'
         api.has_param :draft_adgroup_id, 'string'
@@ -399,9 +447,19 @@ module FacebookAds
       end
     end
 
+    has_edge :ads_reporting_mmm_reports do |edge|
+      edge.get 'AdsReportBuilderMmmReport' do |api|
+        api.has_param :filtering, { list: 'hash' }
+      end
+    end
+
+    has_edge :ads_reporting_mmm_schedulers do |edge|
+      edge.get 'AdsReportBuilderMmmReportScheduler'
+    end
+
     has_edge :ads_volume do |edge|
       edge.get 'AdAccountAdVolume' do |api|
-        api.has_param :page_id, 'int'
+        api.has_param :page_id, 'string'
         api.has_param :recommendation_type, { enum: -> { AdAccountAdVolume::RECOMMENDATION_TYPE }}
         api.has_param :show_breakdown_by_actor, 'bool'
       end
@@ -419,7 +477,8 @@ module FacebookAds
         api.has_param :date_preset, { enum: -> { AdSet::DATE_PRESET }}
         api.has_param :effective_status, { list: { enum: -> { AdSet::EFFECTIVE_STATUS }} }
         api.has_param :is_completed, 'bool'
-        api.has_param :time_range, 'object'
+        api.has_param :time_range, 'hash'
+        api.has_param :updated_since, 'int'
       end
       edge.post 'AdSet' do |api|
         api.has_param :adlabels, { list: 'object' }
@@ -430,6 +489,7 @@ module FacebookAds
         api.has_param :bid_constraints, 'hash'
         api.has_param :bid_strategy, { enum: -> { AdSet::BID_STRATEGY }}
         api.has_param :billing_event, { enum: -> { AdSet::BILLING_EVENT }}
+        api.has_param :campaign_attribution, 'object'
         api.has_param :campaign_id, 'string'
         api.has_param :campaign_spec, 'object'
         api.has_param :creative_sequence, { list: 'string' }
@@ -439,6 +499,8 @@ module FacebookAds
         api.has_param :daily_spend_cap, 'int'
         api.has_param :date_format, 'string'
         api.has_param :destination_type, { enum: -> { AdSet::DESTINATION_TYPE }}
+        api.has_param :dsa_beneficiary, 'string'
+        api.has_param :dsa_payor, 'string'
         api.has_param :end_time, 'datetime'
         api.has_param :execution_options, { list: { enum: -> { AdSet::EXECUTION_OPTIONS }} }
         api.has_param :existing_customer_budget_percentage, 'int'
@@ -450,6 +512,8 @@ module FacebookAds
         api.has_param :lifetime_min_spend_target, 'int'
         api.has_param :lifetime_spend_cap, 'int'
         api.has_param :line_number, 'int'
+        api.has_param :max_budget_spend_percentage, 'int'
+        api.has_param :min_budget_spend_percentage, 'int'
         api.has_param :multi_optimization_goal_weight, { enum: -> { AdSet::MULTI_OPTIMIZATION_GOAL_WEIGHT }}
         api.has_param :name, 'string'
         api.has_param :optimization_goal, { enum: -> { AdSet::OPTIMIZATION_GOAL }}
@@ -457,6 +521,8 @@ module FacebookAds
         api.has_param :pacing_type, { list: 'string' }
         api.has_param :promoted_object, 'object'
         api.has_param :rb_prediction_id, 'string'
+        api.has_param :regional_regulated_categories, { list: { enum: -> { AdSet::REGIONAL_REGULATED_CATEGORIES }} }
+        api.has_param :regional_regulation_identities, 'hash'
         api.has_param :rf_prediction_id, 'string'
         api.has_param :source_adset_id, 'string'
         api.has_param :start_time, 'datetime'
@@ -468,7 +534,6 @@ module FacebookAds
         api.has_param :time_stop, 'datetime'
         api.has_param :topline_id, 'string'
         api.has_param :tune_for_category, { enum: -> { AdSet::TUNE_FOR_CATEGORY }}
-        api.has_param :upstream_events, 'hash'
       end
     end
 
@@ -483,7 +548,7 @@ module FacebookAds
       edge.get 'AdsPixel' do |api|
         api.has_param :sort_by, { enum: -> { AdsPixel::SORT_BY }}
       end
-      edge.post do |api|
+      edge.post 'AdsPixel' do |api|
         api.has_param :name, 'string'
       end
     end
@@ -511,8 +576,6 @@ module FacebookAds
         api.has_param :title, 'string'
       end
       edge.post 'AdVideo' do |api|
-        api.has_param :adaptive_type, 'string'
-        api.has_param :animated_effect_id, 'int'
         api.has_param :application_id, 'string'
         api.has_param :asked_fun_fact_prompt_id, 'int'
         api.has_param :audio_story_wave_animation_handle, 'string'
@@ -537,12 +600,10 @@ module FacebookAds
         api.has_param :formatting, { enum: -> { AdVideo::FORMATTING }}
         api.has_param :fov, 'int'
         api.has_param :front_z_rotation, 'double'
-        api.has_param :fun_fact_prompt_id, 'int'
+        api.has_param :fun_fact_prompt_id, 'string'
         api.has_param :fun_fact_toastee_id, 'int'
         api.has_param :guide, { list: { list: 'int' } }
         api.has_param :guide_enabled, 'bool'
-        api.has_param :has_nickname, 'bool'
-        api.has_param :holiday_card, 'string'
         api.has_param :initial_heading, 'int'
         api.has_param :initial_pitch, 'int'
         api.has_param :instant_game_entry_point_data, 'string'
@@ -551,7 +612,6 @@ module FacebookAds
         api.has_param :is_voice_clip, 'bool'
         api.has_param :location_source_id, 'string'
         api.has_param :name, 'string'
-        api.has_param :offer_like_post_id, 'int'
         api.has_param :og_action_type_id, 'string'
         api.has_param :og_icon_id, 'string'
         api.has_param :og_object_id, 'string'
@@ -560,10 +620,8 @@ module FacebookAds
         api.has_param :original_fov, 'int'
         api.has_param :original_projection_type, { enum: -> { AdVideo::ORIGINAL_PROJECTION_TYPE }}
         api.has_param :publish_event_id, 'int'
-        api.has_param :react_mode_metadata, 'string'
         api.has_param :referenced_sticker_id, 'string'
         api.has_param :replace_video_id, 'string'
-        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'
@@ -597,6 +655,10 @@ module FacebookAds
         api.has_param :business, 'string'
       end
       edge.get 'Business'
+      edge.post 'AdAccount' do |api|
+        api.has_param :business, 'string'
+        api.has_param :permitted_tasks, { list: { enum: -> { AdAccount::PERMITTED_TASKS }} }
+      end
     end
 
     has_edge :applications do |edge|
@@ -642,12 +704,23 @@ module FacebookAds
       end
     end
 
+    has_edge :audience_funnel do |edge|
+      edge.get 'AudienceFunnel'
+    end
+
     has_edge :block_list_drafts do |edge|
       edge.post 'AdAccount' do |api|
         api.has_param :publisher_urls_file, 'file'
       end
     end
 
+    has_edge :brand_safety_content_filter_levels do |edge|
+      edge.post 'AdAccount' do |api|
+        api.has_param :brand_safety_content_filter_levels, { list: { enum: -> { AdAccount::BRAND_SAFETY_CONTENT_FILTER_LEVELS }} }
+        api.has_param :business_id, 'string'
+      end
+    end
+
     has_edge :broadtargetingcategories do |edge|
       edge.get 'BroadTargetingCategories' do |api|
         api.has_param :custom_categories_only, 'bool'
@@ -655,7 +728,7 @@ module FacebookAds
     end
 
     has_edge :businessprojects do |edge|
-      edge.get do |api|
+      edge.get 'BusinessProject' do |api|
         api.has_param :business, 'string'
       end
     end
@@ -671,7 +744,7 @@ module FacebookAds
         api.has_param :date_preset, { enum: -> { Campaign::DATE_PRESET }}
         api.has_param :effective_status, { list: { enum: -> { Campaign::EFFECTIVE_STATUS }} }
         api.has_param :is_completed, 'bool'
-        api.has_param :time_range, 'object'
+        api.has_param :time_range, 'hash'
       end
       edge.post 'Campaign' do |api|
         api.has_param :adlabels, { list: 'object' }
@@ -695,7 +768,6 @@ module FacebookAds
         api.has_param :status, { enum: -> { Campaign::STATUS }}
         api.has_param :stop_time, 'datetime'
         api.has_param :topline_id, 'string'
-        api.has_param :upstream_events, 'hash'
       end
     end
 
@@ -710,28 +782,24 @@ module FacebookAds
       edge.get 'IgUser'
     end
 
-    has_edge :content_delivery_report do |edge|
-      edge.get 'ContentDeliveryReport' do |api|
-        api.has_param :end_date, 'datetime'
-        api.has_param :page_id, 'int'
-        api.has_param :platform, { enum: -> { ContentDeliveryReport::PLATFORM }}
-        api.has_param :position, { enum: -> { ContentDeliveryReport::POSITION }}
-        api.has_param :start_date, 'datetime'
-        api.has_param :summary, 'bool'
+    has_edge :connected_instagram_accounts_with_iabp do |edge|
+      edge.get 'InstagramUser' do |api|
+        api.has_param :business_id, 'string'
       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
+    has_edge :conversion_goals do |edge|
+      edge.get 'AdsConversionGoal'
+    end
+
+    has_edge :cpa_guidance do |edge|
+      edge.get 'BespokePartnerGuidanceLaser'
     end
 
     has_edge :customaudiences do |edge|
       edge.get 'CustomAudience' do |api|
         api.has_param :business_id, 'string'
+        api.has_param :fetch_primary_audience, 'bool'
         api.has_param :fields, { list: 'string' }
         api.has_param :filtering, { list: 'object' }
         api.has_param :pixel_id, 'string'
@@ -750,11 +818,13 @@ module FacebookAds
         api.has_param :event_source_group, 'string'
         api.has_param :event_sources, { list: 'hash' }
         api.has_param :exclusions, { list: 'object' }
+        api.has_param :facebook_page_id, 'string'
         api.has_param :inclusions, { list: 'object' }
         api.has_param :is_snapshot, 'bool'
         api.has_param :is_value_based, 'bool'
         api.has_param :list_of_accounts, { list: 'int' }
         api.has_param :lookalike_spec, 'string'
+        api.has_param :marketing_message_channels, 'object'
         api.has_param :name, 'string'
         api.has_param :opt_out_link, 'string'
         api.has_param :origin_audience_id, 'string'
@@ -768,8 +838,12 @@ module FacebookAds
         api.has_param :rev_share_policy_id, 'int'
         api.has_param :rule, 'string'
         api.has_param :rule_aggregation, 'string'
+        api.has_param :subscription_info, { list: { enum: -> { CustomAudience::SUBSCRIPTION_INFO }} }
         api.has_param :subtype, { enum: -> { CustomAudience::SUBTYPE }}
+        api.has_param :use_for_products, { list: { enum: -> { CustomAudience::USE_FOR_PRODUCTS }} }
+        api.has_param :use_in_campaigns, 'bool'
         api.has_param :video_group_ids, { list: 'string' }
+        api.has_param :whats_app_business_phone_number_id, 'string'
       end
     end
 
@@ -784,6 +858,7 @@ module FacebookAds
     has_edge :customconversions do |edge|
       edge.get 'CustomConversion'
       edge.post 'CustomConversion' do |api|
+        api.has_param :action_source_type, { enum: -> { CustomConversion::ACTION_SOURCE_TYPE }}
         api.has_param :advanced_rule, 'string'
         api.has_param :custom_event_type, { enum: -> { CustomConversion::CUSTOM_EVENT_TYPE }}
         api.has_param :default_conversion_value, 'double'
@@ -808,10 +883,15 @@ module FacebookAds
       end
     end
 
+    has_edge :dsa_recommendations do |edge|
+      edge.get 'AdAccountDsaRecommendations'
+    end
+
     has_edge :generatepreviews do |edge|
       edge.get 'AdPreview' do |api|
         api.has_param :ad_format, { enum: -> { AdPreview::AD_FORMAT }}
         api.has_param :creative, 'AdCreative'
+        api.has_param :creative_feature, { enum: -> { AdPreview::CREATIVE_FEATURE }}
         api.has_param :dynamic_asset_label, 'string'
         api.has_param :dynamic_creative_spec, 'object'
         api.has_param :dynamic_customization, 'object'
@@ -850,8 +930,8 @@ module FacebookAds
         api.has_param :summary, { list: 'string' }
         api.has_param :summary_action_breakdowns, { list: { enum: -> { AdsInsights::SUMMARY_ACTION_BREAKDOWNS }} }
         api.has_param :time_increment, 'string'
-        api.has_param :time_range, 'object'
-        api.has_param :time_ranges, { list: 'object' }
+        api.has_param :time_range, 'hash'
+        api.has_param :time_ranges, { list: 'hash' }
         api.has_param :use_account_attribution_setting, 'bool'
         api.has_param :use_unified_attribution_setting, 'bool'
       end
@@ -873,8 +953,8 @@ module FacebookAds
         api.has_param :summary, { list: 'string' }
         api.has_param :summary_action_breakdowns, { list: { enum: -> { AdsInsights::SUMMARY_ACTION_BREAKDOWNS }} }
         api.has_param :time_increment, 'string'
-        api.has_param :time_range, 'object'
-        api.has_param :time_ranges, { list: 'object' }
+        api.has_param :time_range, 'hash'
+        api.has_param :time_ranges, { list: 'hash' }
         api.has_param :use_account_attribution_setting, 'bool'
         api.has_param :use_unified_attribution_setting, 'bool'
       end
@@ -895,6 +975,10 @@ module FacebookAds
         api.has_param :campaign_group_id, 'int'
         api.has_param :campaign_group_status, { enum: %w{ACTIVE ADSET_PAUSED ARCHIVED CAMPAIGN_PAUSED DELETED DISAPPROVED IN_PROCESS PAUSED PENDING_BILLING_INFO PENDING_REVIEW PREAPPROVED WITH_ISSUES }}
         api.has_param :conversion_domain, 'string'
+        api.has_param :custom_event_type, { enum: %w{ADD_TO_CART CONTENT_VIEW PURCHASE }}
+        api.has_param :daily_budget, 'int'
+        api.has_param :dsa_beneficiary, 'string'
+        api.has_param :dsa_payor, 'string'
         api.has_param :end_time, 'int'
         api.has_param :lifetime_budget, 'int'
         api.has_param :override_creative_text, 'string'
@@ -928,10 +1012,6 @@ module FacebookAds
       end
     end
 
-    has_edge :offline_conversion_data_sets do |edge|
-      edge.get 'OfflineConversionDataSet'
-    end
-
     has_edge :onbehalf_requests do |edge|
       edge.get 'BusinessOwnedObjectOnBehalfOfRequest' do |api|
         api.has_param :status, { enum: -> { BusinessOwnedObjectOnBehalfOfRequest::STATUS }}
@@ -1007,6 +1087,7 @@ module FacebookAds
         api.has_param :impression, 'int'
         api.has_param :instream_packages, { list: { enum: -> { ReachFrequencyPrediction::INSTREAM_PACKAGES }} }
         api.has_param :interval_frequency_cap_reset_period, 'int'
+        api.has_param :is_balanced_frequency, 'bool'
         api.has_param :is_bonus_media, 'bool'
         api.has_param :is_conversion_goal, 'bool'
         api.has_param :is_full_view, 'bool'
@@ -1015,6 +1096,7 @@ module FacebookAds
         api.has_param :is_reserved_buying, 'bool'
         api.has_param :num_curve_points, 'int'
         api.has_param :objective, 'string'
+        api.has_param :optimization_goal, 'string'
         api.has_param :prediction_mode, 'int'
         api.has_param :reach, 'int'
         api.has_param :rf_prediction_id, 'string'
@@ -1024,11 +1106,20 @@ module FacebookAds
         api.has_param :stop_time, 'int'
         api.has_param :story_event_type, 'int'
         api.has_param :target_cpm, 'int'
+        api.has_param :target_frequency, 'int'
+        api.has_param :target_frequency_reset_period, 'int'
         api.has_param :target_spec, 'Targeting'
         api.has_param :video_view_length_constraint, 'int'
       end
     end
 
+    has_edge :recommendations do |edge|
+      edge.get 'AdAccountRecommendations'
+      edge.post 'AdAccountRecommendations' do |api|
+        api.has_param :recommendation_signature, 'string'
+      end
+    end
+
     has_edge :saved_audiences do |edge|
       edge.get 'SavedAudience' do |api|
         api.has_param :business_id, 'string'
@@ -1054,6 +1145,7 @@ module FacebookAds
         api.has_param :is_exclusion, 'bool'
         api.has_param :limit_type, { enum: -> { AdAccountTargetingUnified::LIMIT_TYPE }}
         api.has_param :regulated_categories, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_CATEGORIES }} }
+        api.has_param :regulated_countries, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_COUNTRIES }} }
         api.has_param :whitelisted_types, { list: { enum: -> { AdAccountTargetingUnified::WHITELISTED_TYPES }} }
       end
     end
@@ -1063,12 +1155,15 @@ module FacebookAds
         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_account_level_brand_safety_exclusion, 'bool'
+        api.has_param :is_account_level_employer_exclusion, 'bool'
         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 :regulated_countries, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_COUNTRIES }} }
         api.has_param :session_id, 'int'
         api.has_param :targeting_list, { list: 'object' }
         api.has_param :whitelisted_types, { list: { enum: -> { AdAccountTargetingUnified::WHITELISTED_TYPES }} }
@@ -1093,6 +1188,7 @@ module FacebookAds
         api.has_param :objective, { enum: -> { AdAccountTargetingUnified::OBJECTIVE }}
         api.has_param :objects, 'object'
         api.has_param :regulated_categories, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_CATEGORIES }} }
+        api.has_param :regulated_countries, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_COUNTRIES }} }
         api.has_param :session_id, 'int'
         api.has_param :targeting_list, { list: 'object' }
         api.has_param :whitelisted_types, { list: { enum: -> { AdAccountTargetingUnified::WHITELISTED_TYPES }} }
@@ -1127,5 +1223,20 @@ module FacebookAds
       end
     end
 
+    has_edge :value_adjustment_rules do |edge|
+      edge.get 'AdsValueAdjustmentRule'
+    end
+
+    has_edge :value_rule_set do |edge|
+      edge.get 'AdsValueAdjustmentRuleCollection'
+    end
+
+    has_edge :video_ads do |edge|
+      edge.get 'AdVideo' do |api|
+        api.has_param :since, 'datetime'
+        api.has_param :until, 'datetime'
+      end
+    end
+
   end
 end