facebookbusiness 26.0.0 → 26.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '02592592c6b10e463bb2f21fe2b2a143088fbce2d718535df1021c0451f5a398'
-  data.tar.gz: e739ed3b1a92b1a32ba02810cf83c84e927c73f4f5cbfcf2f6570056b62ec9ef
+  metadata.gz: f6bfd0834b5b9498579404af2e9af523329bfe6a3377c5791ff838f680631c75
+  data.tar.gz: 7004d3586d10b4bce123083e35cb803a8f45ef0f2e48127e050814e9bb6454ef
 SHA512:
-  metadata.gz: 4a82a4b120f8b23dc8b829d7d4139c3cc0185175cf9daa19bb668ece7b7d4f6d25f133626d3595a0061166d7a66c54653c868e8fd944fcbbecf307c5a282951b
-  data.tar.gz: 9dab08b13effeac1ce6d062635794f75bf0c860d07e976f9182f3fde190f2202bca6141927a5be1c3b7d2e82f32d47eeb5963e214a993d5c8acff21e37f03b6f
+  metadata.gz: 56a003ae4d106338f1cd6341eaaec350a40b818d4e0d5c923711d995b3beac9d32d7a00ff326989d21055dcf5d6771186f0bdf4b8835d3aecae1c88a48e1f5e7
+  data.tar.gz: 93c1e5103b56a693af31481b38a542e1b2dbfcdea233f4dcc684a12524f70b519e08a6bbb2483fd61e6b595eaf9e81973afaaa6293eba6f120206a6ebec6f6d9

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -502,41 +502,41 @@ module FacebookAds
         api.has_param :time_range, 'hash'
         api.has_param :updated_since, 'int'
       end
-      edge.post 'AdSet' do |api|
+      edge.post do |api|
         api.has_param :ad_set_goal, 'hash'
         api.has_param :adlabels, { list: 'object' }
         api.has_param :adset_schedule, { list: 'object' }
-        api.has_param :attribution_count_type, { enum: -> { AdSet::ATTRIBUTION_COUNT_TYPE }}
+        api.has_param :attribution_count_type, { enum: %w{ALL_CONVERSIONS FIRST_CONVERSION }}
         api.has_param :attribution_spec, { list: 'hash' }
-        api.has_param :automatic_manual_state, { enum: -> { AdSet::AUTOMATIC_MANUAL_STATE }}
+        api.has_param :automatic_manual_state, { enum: %w{AUTOMATIC MANUAL UNSET }}
         api.has_param :bid_adjustments, 'object'
         api.has_param :bid_amount, 'int'
         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 :bid_strategy, { enum: %w{COST_CAP LOWEST_COST_WITHOUT_CAP LOWEST_COST_WITH_BID_CAP LOWEST_COST_WITH_MIN_ROAS }}
+        api.has_param :billing_event, { enum: %w{APP_INSTALLS CLICKS IMPRESSIONS LINK_CLICKS LISTING_INTERACTION NONE OFFER_CLAIMS PAGE_LIKES POST_ENGAGEMENT PURCHASE THRUPLAY }}
         api.has_param :brand_safety_config, 'hash'
         api.has_param :budget_schedule_specs, { list: 'object' }
-        api.has_param :budget_source, { enum: -> { AdSet::BUDGET_SOURCE }}
+        api.has_param :budget_source, { enum: %w{NONE RMN }}
         api.has_param :budget_split_set_id, 'string'
         api.has_param :campaign_attribution, 'object'
         api.has_param :campaign_id, 'string'
         api.has_param :campaign_spec, 'object'
-        api.has_param :cost_bidding_mode, { enum: -> { AdSet::COST_BIDDING_MODE }}
+        api.has_param :cost_bidding_mode, { enum: %w{BALANCED COST_FOCUSED VOLUME_FOCUSED }}
         api.has_param :creative_sequence, { list: 'string' }
-        api.has_param :creative_sequence_repetition_pattern, { enum: -> { AdSet::CREATIVE_SEQUENCE_REPETITION_PATTERN }}
+        api.has_param :creative_sequence_repetition_pattern, { enum: %w{FULL_SEQUENCE LAST_AD }}
         api.has_param :daily_budget, 'int'
         api.has_param :daily_imps, 'int'
         api.has_param :daily_min_spend_target, 'int'
         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 :destination_type, { enum: %w{APP APPLINKS_AUTOMATIC FACEBOOK FACEBOOK_LIVE FACEBOOK_PAGE IMAGINE INSTAGRAM_DIRECT INSTAGRAM_LIVE INSTAGRAM_PROFILE INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE MESSAGING_INSTAGRAM_DIRECT_MESSENGER MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP MESSAGING_INSTAGRAM_DIRECT_WHATSAPP MESSAGING_MESSENGER_WHATSAPP MESSENGER ON_AD ON_EVENT ON_PAGE ON_POST ON_VIDEO SHOP_AUTOMATIC WEBSITE WHATSAPP }}
         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 :execution_options, { list: { enum: %w{include_recommendations validate_only }} }
         api.has_param :existing_customer_budget_percentage, 'int'
         api.has_param :frequency_control_specs, { list: 'object' }
-        api.has_param :full_funnel_exploration_mode, { enum: -> { AdSet::FULL_FUNNEL_EXPLORATION_MODE }}
+        api.has_param :full_funnel_exploration_mode, { enum: %w{EXTENDED_EXPLORATION LIMITED_EXPLORATION NONE_EXPLORATION }}
         api.has_param :is_ba_skip_delayed_eligible, 'bool'
         api.has_param :is_budget_schedule_enabled, 'bool'
         api.has_param :is_dc_follow_optimized, 'bool'
@@ -554,21 +554,21 @@ module FacebookAds
         api.has_param :meta_moment_maker_spec, 'hash'
         api.has_param :min_budget_spend_percentage, 'int'
         api.has_param :multi_event_conversion_attribution_window_seconds, 'int'
-        api.has_param :multi_optimization_goal_weight, { enum: -> { AdSet::MULTI_OPTIMIZATION_GOAL_WEIGHT }}
+        api.has_param :multi_optimization_goal_weight, { enum: %w{BALANCED PREFER_EVENT PREFER_INSTALL UNDEFINED }}
         api.has_param :name, 'string'
-        api.has_param :optimization_goal, { enum: -> { AdSet::OPTIMIZATION_GOAL }}
-        api.has_param :optimization_sub_event, { enum: -> { AdSet::OPTIMIZATION_SUB_EVENT }}
+        api.has_param :optimization_goal, { enum: %w{ADVERTISER_SILOED_VALUE AD_RECALL_LIFT APP_INSTALLS APP_INSTALLS_AND_OFFSITE_CONVERSIONS AUTOMATIC_OBJECTIVE CONVERSATIONS DERIVED_EVENTS ENGAGED_PAGE_VIEWS ENGAGED_USERS EVENT_RESPONSES IMPRESSIONS IN_APP_VALUE LANDING_PAGE_VIEWS LEAD_GENERATION LINK_CLICKS MEANINGFUL_CALL_ATTEMPT MESSAGING_APPOINTMENT_CONVERSION MESSAGING_DEEP_CONVERSATION_AND_FOLLOW MESSAGING_PURCHASE_CONVERSION NONE OFFSITE_CONVERSIONS PAGE_LIKES POST_ENGAGEMENT PROFILE_AND_PAGE_ENGAGEMENT PROFILE_VISIT QUALITY_CALL QUALITY_LEAD REACH REMINDERS_SET SUBSCRIBERS THRUPLAY VALUE VISIT_INSTAGRAM_PROFILE }}
+        api.has_param :optimization_sub_event, { enum: %w{NONE POST_INTERACTION TRAVEL_INTENT TRAVEL_INTENT_BUCKET_01 TRAVEL_INTENT_BUCKET_02 TRAVEL_INTENT_BUCKET_03 TRAVEL_INTENT_BUCKET_04 TRAVEL_INTENT_BUCKET_05 TRAVEL_INTENT_NO_DESTINATION_INTENT TRIP_CONSIDERATION VIDEO_SOUND_ON }}
         api.has_param :pacing_type, { list: 'string' }
         api.has_param :placement_soft_opt_out, 'object'
         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_regulated_categories, { list: { enum: %w{0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 24 }} }
         api.has_param :regional_regulation_identities, 'hash'
         api.has_param :relative_value, 'double'
         api.has_param :rf_prediction_id, 'string'
         api.has_param :source_adset_id, 'string'
         api.has_param :start_time, 'datetime'
-        api.has_param :status, { enum: -> { AdSet::STATUS }}
+        api.has_param :status, { enum: %w{ACTIVE ARCHIVED DELETED PAUSED }}
         api.has_param :targeting, 'Targeting'
         api.has_param :time_based_ad_rotation_id_blocks, { list: { list: 'int' } }
         api.has_param :time_based_ad_rotation_intervals, { list: 'int' }
@@ -576,7 +576,7 @@ module FacebookAds
         api.has_param :time_stop, 'datetime'
         api.has_param :topline_id, 'string'
         api.has_param :trending_topics_spec, 'hash'
-        api.has_param :tune_for_category, { enum: -> { AdSet::TUNE_FOR_CATEGORY }}
+        api.has_param :tune_for_category, { enum: %w{CREDIT EMPLOYMENT FINANCIAL_PRODUCTS_SERVICES HOUSING ISSUES_ELECTIONS_POLITICS NONE ONLINE_GAMBLING_AND_GAMING }}
         api.has_param :value_rule_set_id, 'string'
         api.has_param :value_rules_applied, 'bool'
       end
@@ -1212,7 +1212,10 @@ module FacebookAds
     end
 
     has_edge :recommendations do |edge|
-      edge.get 'AdAccountRecommendations'
+      edge.get 'AdAccountRecommendations' do |api|
+        api.has_param :recommendation_names, { list: { enum: -> { AdAccountRecommendations::RECOMMENDATION_NAMES }} }
+        api.has_param :recommendation_stages, { list: { enum: -> { AdAccountRecommendations::RECOMMENDATION_STAGES }} }
+      end
       edge.post 'AdAccountRecommendations' do |api|
         api.has_param :asc_fragmentation_parameters, 'hash'
         api.has_param :autoflow_parameters, 'hash'
@@ -1247,7 +1250,9 @@ module FacebookAds
         api.has_param :excluded_category, 'string'
         api.has_param :include_nodes, 'bool'
         api.has_param :is_exclusion, 'bool'
+        api.has_param :is_reserved, 'bool'
         api.has_param :limit_type, { enum: -> { AdAccountTargetingUnified::LIMIT_TYPE }}
+        api.has_param :optimization_goal, { enum: -> { AdAccountTargetingUnified::OPTIMIZATION_GOAL }}
         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 }} }
@@ -1262,8 +1267,10 @@ module FacebookAds
         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 :is_reserved, 'bool'
         api.has_param :limit_type, { enum: -> { AdAccountTargetingUnified::LIMIT_TYPE }}
         api.has_param :objective, { enum: -> { AdAccountTargetingUnified::OBJECTIVE }}
+        api.has_param :optimization_goal, { enum: -> { AdAccountTargetingUnified::OPTIMIZATION_GOAL }}
         api.has_param :promoted_object, 'object'
         api.has_param :q, 'string'
         api.has_param :regulated_categories, { list: { enum: -> { AdAccountTargetingUnified::REGULATED_CATEGORIES }} }

data/lib/facebook_ads/ad_objects/ad_account_ad_videos.rb

@@ -0,0 +1,46 @@
+# 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
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdAccountAdVideos < AdObject
+
+    field :id, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+    has_edge :advideos do |edge|
+      edge.get 'AdAccountAdVideosGet' do |api|
+        api.has_param :ad_account_id, 'int'
+        api.has_param :after, 'string'
+        api.has_param :before, 'string'
+        api.has_param :fields, 'string'
+        api.has_param :has_integrity_violation, 'bool'
+        api.has_param :limit, 'int'
+        api.has_param :max_aspect_ratio, 'double'
+        api.has_param :maxheight, 'int'
+        api.has_param :maxlength, 'int'
+        api.has_param :maxwidth, 'int'
+        api.has_param :min_aspect_ratio, 'double'
+        api.has_param :minheight, 'int'
+        api.has_param :minlength, 'int'
+        api.has_param :minwidth, 'int'
+        api.has_param :originalvideo, 'bool'
+        api.has_param :summary, 'string'
+        api.has_param :title, 'string'
+      end
+    end
+
+  end
+end

data/lib/facebook_ads/ad_objects/{page_about_story_composed_block_entity_ranges.rb → ad_account_ad_videos_get.rb}

@@ -13,11 +13,11 @@ 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 PageAboutStoryComposedBlockEntityRanges < AdObject
+  class AdAccountAdVideosGet < AdObject
 
-    field :key, 'string'
-    field :length, 'int'
-    field :offset, 'int'
+    field :data, { list: 'object' }
+    field :paging, 'object'
+    field :summary, 'object'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -31,7 +31,9 @@ module FacebookAds
       "ADOPT_DAYPARTING_CTX_DEEP_CONVERSATIONS",
       "ADOPT_GEN_AI_MVP_CHILD",
       "ADOPT_INBOX_QUESTIONS_IN_ADS_MANAGER_CTM",
+      "ADOPT_INSTANT_EXPERIENCE_DESTINATION",
       "ADOPT_PRODUCT_EXTENSIONS_CHILD",
+      "ADOPT_PRODUCT_EXTENSIONS_CTM_OR_CTWA",
       "ADOPT_RELATED_MEDIA_SUGGESTIONS",
       "ADOPT_SINGLE_MEDIA_AD_FORMAT_BUNDLE",
       "ADOPT_SMS_VERIFICATION_FOR_LEAD_QUALITY",
@@ -46,6 +48,7 @@ module FacebookAds
       "ADVANTAGE_CUSTOM_AUDIENCE_DUPLICATION",
       "ADVANTAGE_CUSTOM_AUDIENCE_UPSELL",
       "ADVANTAGE_DETAILED_TARGETING",
+      "ADVANTAGE_DEVICE_GUIDANCE",
       "ADVANTAGE_LOOKALIKE_AUDIENCE",
       "ADVANTAGE_LOOKALIKE_DUPLICATION",
       "ADVANTAGE_PLUS_APP_CAMPAIGN",
@@ -216,7 +219,6 @@ module FacebookAds
       "CTX_SABR_NON_CBO",
       "CTX_SMART_DEFAULTING",
       "CTX_VALUE_OPTIMIZATION_CTM_PO_TO_VO",
-      "CTX_ZERO_OUTCOME_BUDGET",
       "CTX_ZO_CBO",
       "CTX_ZO_NON_CBO",
       "CUSTOM_AUDIENCE_RELAXATION",
@@ -237,6 +239,7 @@ module FacebookAds
       "ENABLE_AI_GENERATED_ICEBREAKERS_FOR_CTX",
       "ENABLE_AI_GENERATED_RESPONSES_CTM",
       "ENABLE_WHATS_APP_ADS_DATA_SHARING",
+      "ENFORCE_WORK_EMAIL",
       "ENGAGED_VIEW_CONVERSIONS_CREATION",
       "EVC_APP_DUPLICATION_UPGRADE",
       "EVC_WEB_DUPLICATION_UPGRADE",
@@ -281,6 +284,7 @@ module FacebookAds
       "LIVE_VIDEO_ADS",
       "LOW_BUDGET_UTILIZATION",
       "LOW_OUTCOME",
+      "LULUTONG_GLMT_E2E_TEST",
       "MANUAL_BIDDING_BUDGET_LIMITED",
       "MARKETING_MESSAGES",
       "MERLIN_GUIDANCE",
@@ -313,6 +317,7 @@ module FacebookAds
       "OFFSITE_CONVERSION_V2",
       "OMNI_OPTIMIZATION",
       "OPTIMAL_BAU",
+      "OPT_INTO_ADD_ANIMATION_IN_APLUS_CREATIVE",
       "OPT_INTO_CHAT_ON_WHATSAPP_POST_LEAD",
       "OPT_INTO_NUDGE_FOLLOW_UP_MESSAGES_CTM",
       "OPT_INTO_REELS_GEN_AI_VIDEO_EXPANSION",
@@ -377,6 +382,7 @@ module FacebookAds
       "SEMANTIC_BASED_AUDIENCE_DUPLICATION",
       "SEMANTIC_BASED_AUDIENCE_EXPANSION",
       "SETUP_PIXEL",
+      "SGP_UGP_TEST_GUIDANCE_1",
       "SHOPS_ADS",
       "SHOPS_ADS_DUPLICATION",
       "SHOPS_ADS_SAOFF",
@@ -404,12 +410,14 @@ module FacebookAds
       "TAILORED_LEAD_AD_CAMPAIGN",
       "TAILORED_MESSAGES_CAMPAIGN",
       "TARGETING_CREATIVE_FRAGMENTATION",
+      "THIVIYA_SALES_GUIDANCE_E2E_TEST",
       "THREECO_WEB_PLUS_APP_APLUSD",
       "THREECO_WEB_PLUS_APP_UPSELL",
       "TLA_CREATION_PACKAGE",
       "TOP_ADSETS_WITH_ADS_UNDER_CAP",
       "TOP_CAMPAIGNS_WITH_ADS_UNDER_CAP",
       "TRANSLATION_DEFAULT_ON",
+      "TRANSLATION_INSIGHTS",
       "TWO_P_GUIDANCE_CARD_AAA",
       "TWO_P_GUIDANCE_CARD_AUTO_PLACEMENT",
       "TWO_P_GUIDANCE_CARD_CBO_OFF",
@@ -440,6 +448,7 @@ module FacebookAds
       "WEB_ENGAGED_VIEW_CONVERSIONS",
       "WTWA_UPSELL_IN_DUPLICATION",
       "WTWA_UPSELL_IN_SYD_AND_AM_TABLE",
+      "YIJINGC_TEST",
       "YI_TEST",
       "ZERO_CONVERSION",
       "ZERO_IMPRESSION",

data/lib/facebook_ads/ad_objects/ad_account_ads_reporting_report_specs.rb

@@ -0,0 +1,36 @@
+# 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
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdAccountAdsReportingReportSpecs < AdObject
+
+    field :id, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+    has_edge :ads_reporting_report_specs do |edge|
+      edge.get 'AdAccountAdsReportingReportSpecsGet' do |api|
+        api.has_param :after, 'string'
+        api.has_param :before, 'string'
+        api.has_param :fields, 'string'
+        api.has_param :filtering, 'string'
+        api.has_param :limit, 'int'
+        api.has_param :sorting, 'string'
+        api.has_param :summary, 'string'
+      end
+    end
+
+  end
+end

data/lib/facebook_ads/ad_objects/{page_about_story_composed_block_inline_style.rb → ad_account_ads_reporting_report_specs_get.rb}

@@ -13,11 +13,10 @@ 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 PageAboutStoryComposedBlockInlineStyle < AdObject
+  class AdAccountAdsReportingReportSpecsGet < AdObject
 
-    field :length, 'int'
-    field :offset, 'int'
-    field :style, 'string'
+    field :data, { list: 'object' }
+    field :paging, 'object'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_account_creative_stickers.rb

@@ -0,0 +1,28 @@
+# 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
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdAccountCreativeStickers < AdObject
+
+    field :id, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+    has_edge :creative_stickers do |edge|
+      edge.post 'AdAccountCreativeStickersPost'
+    end
+
+  end
+end

data/lib/facebook_ads/ad_objects/ad_account_creative_stickers_post.rb

@@ -0,0 +1,26 @@
+# 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
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class AdAccountCreativeStickersPost < AdObject
+
+    field :id, 'string'
+    field :status, 'string'
+    field :success, 'bool'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end