Auto-generated python SDK code update

Summary: ignore-conflict-markers

Reviewed By: satwikareddy3

Differential Revision: D95912354

fbshipit-source-id: cad1b5b3e822ed00dee7f6b8e9b61ddccc0461eb

Author: generatedunixname89002005295453

facebook_business/__init__.py

@@ -7,5 +7,5 @@
 from facebook_business.session import FacebookSession
 from facebook_business.api import FacebookAdsApi
 
-__version__ = '24.0.0'
+__version__ = '25.0.0'
 __all__ = ['session', 'api']

facebook_business/adobjects/abtestposttestactions.py

@@ -25,9 +25,11 @@ def __init__(self, api=None):
 
     class Field(AbstractObject.Field):
         auto_change_budget_to_winner = 'auto_change_budget_to_winner'
+        winner_budget = 'winner_budget'
 
     _field_types = {
         'auto_change_budget_to_winner': 'int',
+        'winner_budget': 'string',
     }
     @classmethod
     def _get_field_enum_info(cls):

facebook_business/adobjects/adaccount.py

@@ -80,10 +80,12 @@ class Field(AbstractObject.Field):
         is_tax_id_required = 'is_tax_id_required'
         liable_address = 'liable_address'
         line_numbers = 'line_numbers'
+        marketing_messages_settings = 'marketing_messages_settings'
         media_agency = 'media_agency'
         min_campaign_group_spend_cap = 'min_campaign_group_spend_cap'
         min_daily_budget = 'min_daily_budget'
         name = 'name'
+        offsite_clo_signal_status = 'offsite_clo_signal_status'
         offsite_pixels_tos_accepted = 'offsite_pixels_tos_accepted'
         opportunity_score = 'opportunity_score'
         owner = 'owner'
@@ -185,6 +187,7 @@ class BrandSafetyContentFilterLevels:
         facebook_standard = 'FACEBOOK_STANDARD'
         facebook_strict = 'FACEBOOK_STRICT'
         feed_dnm = 'FEED_DNM'
+        feed_nested_dnm = 'FEED_NESTED_DNM'
         feed_relaxed = 'FEED_RELAXED'
         feed_standard = 'FEED_STANDARD'
         feed_strict = 'FEED_STRICT'
@@ -702,6 +705,7 @@ def create_ad_creative(self, fields=None, params=None, batch=None, success=None,
             'is_dco_internal': 'bool',
             'link_og_id': 'string',
             'link_url': 'string',
+            'marketing_message_structured_spec': 'map',
             'media_sourcing_spec': 'map',
             'name': 'string',
             'object_id': 'unsigned int',
@@ -716,8 +720,10 @@ def create_ad_creative(self, fields=None, params=None, batch=None, success=None,
             'playable_asset_id': 'string',
             'portrait_customizations': 'map',
             'product_set_id': 'string',
+            'product_suggestion_settings': 'map',
             'recommender_settings': 'map',
             'regional_regulation_disclaimer_spec': 'map',
+            'source_facebook_post_id': 'string',
             'source_instagram_media_id': 'string',
             'template_url': 'string',
             'template_url_spec': 'string',
@@ -796,6 +802,7 @@ def delete_ad_images(self, fields=None, params=None, batch=None, success=None, f
           api_utils.warning('`success` and `failure` callback only work for batch call.')
         param_types = {
             'hash': 'string',
+            'image_id': 'string',
         }
         enums = {
         }
@@ -1728,6 +1735,7 @@ def create_ad_video(self, fields=None, params=None, batch=None, success=None, fa
             'content_category': 'content_category_enum',
             'creative_tools': 'string',
             'description': 'string',
+            'edit_description_spec': 'map',
             'embeddable': 'bool',
             'end_offset': 'unsigned int',
             'fbuploader_video_file_chunk': 'string',
@@ -2775,6 +2783,7 @@ def create_custom_audience(self, fields=None, params=None, batch=None, success=N
             'rule_aggregation': 'string',
             'subscription_info': 'list<subscription_info_enum>',
             'subtype': 'subtype_enum',
+            'usage_restriction': 'usage_restriction_enum',
             'use_for_products': 'list<use_for_products_enum>',
             'use_in_campaigns': 'bool',
             'video_group_ids': 'list<string>',
@@ -2786,6 +2795,7 @@ def create_custom_audience(self, fields=None, params=None, batch=None, success=N
             'customer_file_source_enum': CustomAudience.CustomerFileSource.__dict__.values(),
             'subscription_info_enum': CustomAudience.SubscriptionInfo.__dict__.values(),
             'subtype_enum': CustomAudience.Subtype.__dict__.values(),
+            'usage_restriction_enum': CustomAudience.UsageRestriction.__dict__.values(),
             'use_for_products_enum': CustomAudience.UseForProducts.__dict__.values(),
         }
         request = FacebookRequest(
@@ -3929,6 +3939,7 @@ def create_recommendation(self, fields=None, params=None, batch=None, success=No
         param_types = {
             'asc_fragmentation_parameters': 'map',
             'autoflow_parameters': 'map',
+            'extra_data': 'map',
             'fragmentation_parameters': 'map',
             'music_parameters': 'map',
             'recommendation_signature': 'string',
@@ -4495,6 +4506,37 @@ def create_value_rule_set(self, fields=None, params=None, batch=None, success=No
             self.assure_call()
             return request.execute()
 
+    def create_value_rule_set_translation(self, fields=None, params=None, batch=None, success=None, failure=None, pending=False):
+        from facebook_business.utils import api_utils
+        if batch is None and (success is not None or failure is not None):
+          api_utils.warning('`success` and `failure` callback only work for batch call.')
+        param_types = {
+            'source': 'Object',
+        }
+        enums = {
+        }
+        request = FacebookRequest(
+            node_id=self['id'],
+            method='POST',
+            endpoint='/value_rule_set_translation',
+            api=self._api,
+            param_checker=TypeChecker(param_types, enums),
+            target_class=AbstractCrudObject,
+            api_type='EDGE',
+            response_parser=ObjectParser(target_class=AbstractCrudObject, api=self._api),
+        )
+        request.add_params(params)
+        request.add_fields(fields)
+
+        if batch is not None:
+            request.add_to_batch(batch, success=success, failure=failure)
+            return request
+        elif pending:
+            return request
+        else:
+            self.assure_call()
+            return request.execute()
+
     def get_video_ads(self, fields=None, params=None, batch=None, success=None, failure=None, pending=False):
         from facebook_business.utils import api_utils
         if batch is None and (success is not None or failure is not None):
@@ -4617,10 +4659,12 @@ def create_video_ad(self, fields=None, params=None, batch=None, success=None, fa
         'is_tax_id_required': 'bool',
         'liable_address': 'CRMAddress',
         'line_numbers': 'list<int>',
+        'marketing_messages_settings': 'AdAccountMarketingMessagesSettings',
         'media_agency': 'string',
         'min_campaign_group_spend_cap': 'string',
         'min_daily_budget': 'unsigned int',
         'name': 'string',
+        'offsite_clo_signal_status': 'int',
         'offsite_pixels_tos_accepted': 'bool',
         'opportunity_score': 'float',
         'owner': 'string',

facebook_business/adobjects/adaccountadruleshistory.py

@@ -50,10 +50,13 @@ class Action:
         enable_gen_uncrop = 'ENABLE_GEN_UNCROP'
         enable_landing_page_views = 'ENABLE_LANDING_PAGE_VIEWS'
         enable_music = 'ENABLE_MUSIC'
+        enable_pixelless_lpv_optimization_goal = 'ENABLE_PIXELLESS_LPV_OPTIMIZATION_GOAL'
         enable_product_set_boosting = 'ENABLE_PRODUCT_SET_BOOSTING'
         enable_reels_placements = 'ENABLE_REELS_PLACEMENTS'
         enable_semantic_based_audience_expansion = 'ENABLE_SEMANTIC_BASED_AUDIENCE_EXPANSION'
         enable_shops_ads = 'ENABLE_SHOPS_ADS'
+        enable_shops_ads_saoff = 'ENABLE_SHOPS_ADS_SAOFF'
+        enable_wtwa_upsell_in_duplication = 'ENABLE_WTWA_UPSELL_IN_DUPLICATION'
         endpoint_pinged = 'ENDPOINT_PINGED'
         error = 'ERROR'
         facebook_notification_sent = 'FACEBOOK_NOTIFICATION_SENT'

facebook_business/adobjects/adaccountadvolume.py

@@ -45,6 +45,16 @@ class RecommendationType:
         account_spend_limit = 'ACCOUNT_SPEND_LIMIT'
         account_spend_limit_duplication = 'ACCOUNT_SPEND_LIMIT_DUPLICATION'
         aco_toggle = 'ACO_TOGGLE'
+        add_funds_to_run_campaign = 'ADD_FUNDS_TO_RUN_CAMPAIGN'
+        adopt_creative_media_sourcing_bundle = 'ADOPT_CREATIVE_MEDIA_SOURCING_BUNDLE'
+        adopt_ctx_recommended_template_bundle = 'ADOPT_CTX_RECOMMENDED_TEMPLATE_BUNDLE'
+        adopt_gen_ai_mvp_child = 'ADOPT_GEN_AI_MVP_CHILD'
+        adopt_inbox_questions_in_ads_manager_ctm = 'ADOPT_INBOX_QUESTIONS_IN_ADS_MANAGER_CTM'
+        adopt_product_extensions_child = 'ADOPT_PRODUCT_EXTENSIONS_CHILD'
+        adopt_related_media_suggestions = 'ADOPT_RELATED_MEDIA_SUGGESTIONS'
+        adopt_single_media_ad_format_bundle = 'ADOPT_SINGLE_MEDIA_AD_FORMAT_BUNDLE'
+        adopt_sms_verification_for_lead_quality = 'ADOPT_SMS_VERIFICATION_FOR_LEAD_QUALITY'
+        adopt_website_to_messenger = 'ADOPT_WEBSITE_TO_MESSENGER'
         adset_budget_sharing = 'ADSET_BUDGET_SHARING'
         ads_reporting = 'ADS_REPORTING'
         ads_status = 'ADS_STATUS'
@@ -142,6 +152,7 @@ class RecommendationType:
         budget_seasonal_guidance = 'BUDGET_SEASONAL_GUIDANCE'
         business_ai_agent_upsell = 'BUSINESS_AI_AGENT_UPSELL'
         call_ads_dayparting_l3_recommendation = 'CALL_ADS_DAYPARTING_L3_RECOMMENDATION'
+        call_ads_l2_dayparting = 'CALL_ADS_L2_DAYPARTING'
         campaign_consolidation_with_flex = 'CAMPAIGN_CONSOLIDATION_WITH_FLEX'
         campaign_guidance_navigator_reels_tips = 'CAMPAIGN_GUIDANCE_NAVIGATOR_REELS_TIPS'
         campaign_spend_limit = 'CAMPAIGN_SPEND_LIMIT'
@@ -167,6 +178,8 @@ class RecommendationType:
         conversion_leads_optimization_integrated = 'CONVERSION_LEADS_OPTIMIZATION_INTEGRATED'
         conversion_leads_optimization_v2 = 'CONVERSION_LEADS_OPTIMIZATION_V2'
         conversion_lead_ads = 'CONVERSION_LEAD_ADS'
+        convert_app_web_fallback_to_a_destination = 'CONVERT_APP_WEB_FALLBACK_TO_A_DESTINATION'
+        convert_ig_profile_visit_to_ptwa = 'CONVERT_IG_PROFILE_VISIT_TO_PTWA'
         cost_goal = 'COST_GOAL'
         cost_goal_budget_limited = 'COST_GOAL_BUDGET_LIMITED'
         cost_goal_cpa_limited = 'COST_GOAL_CPA_LIMITED'
@@ -226,10 +239,13 @@ class RecommendationType:
         dynamic_advantage_campaign_budget = 'DYNAMIC_ADVANTAGE_CAMPAIGN_BUDGET'
         ecosystem_bid_reduce_l1_cardinality = 'ECOSYSTEM_BID_REDUCE_L1_CARDINALITY'
         email_capture_upsell_guidance = 'EMAIL_CAPTURE_UPSELL_GUIDANCE'
+        enable_ai_generated_icebreakers_for_ctx = 'ENABLE_AI_GENERATED_ICEBREAKERS_FOR_CTX'
+        enable_ai_generated_responses_ctm = 'ENABLE_AI_GENERATED_RESPONSES_CTM'
         enable_whats_app_ads_data_sharing = 'ENABLE_WHATS_APP_ADS_DATA_SHARING'
         engaged_view_conversions_creation = 'ENGAGED_VIEW_CONVERSIONS_CREATION'
         evc_app_duplication_upgrade = 'EVC_APP_DUPLICATION_UPGRADE'
         evc_web_duplication_upgrade = 'EVC_WEB_DUPLICATION_UPGRADE'
+        experimentation_framework_test = 'EXPERIMENTATION_FRAMEWORK_TEST'
         f2_conversion_location = 'F2_CONVERSION_LOCATION'
         fragmentation = 'FRAGMENTATION'
         fragmentation_resolution_update = 'FRAGMENTATION_RESOLUTION_UPDATE'
@@ -261,6 +277,7 @@ class RecommendationType:
         live_video_ads = 'LIVE_VIDEO_ADS'
         low_budget_utilization = 'LOW_BUDGET_UTILIZATION'
         low_outcome = 'LOW_OUTCOME'
+        manual_bidding_budget_limited = 'MANUAL_BIDDING_BUDGET_LIMITED'
         marketing_messages = 'MARKETING_MESSAGES'
         merlin_guidance = 'MERLIN_GUIDANCE'
         messaging_events = 'MESSAGING_EVENTS'
@@ -292,6 +309,9 @@ class RecommendationType:
         offsite_conversion_v2 = 'OFFSITE_CONVERSION_V2'
         omni_optimization = 'OMNI_OPTIMIZATION'
         optimal_bau = 'OPTIMAL_BAU'
+        opt_into_chat_on_whatsapp_post_lead = 'OPT_INTO_CHAT_ON_WHATSAPP_POST_LEAD'
+        opt_into_nudge_follow_up_messages_ctm = 'OPT_INTO_NUDGE_FOLLOW_UP_MESSAGES_CTM'
+        opt_into_single_media_to_collection_ads = 'OPT_INTO_SINGLE_MEDIA_TO_COLLECTION_ADS'
         outcome_forecaster_budget_recommendation = 'OUTCOME_FORECASTER_BUDGET_RECOMMENDATION'
         outcome_forecaster_shadow_logging = 'OUTCOME_FORECASTER_SHADOW_LOGGING'
         partnership_ads = 'PARTNERSHIP_ADS'
@@ -311,10 +331,12 @@ class RecommendationType:
         pixel_upsell = 'PIXEL_UPSELL'
         pixel_upsell_v2 = 'PIXEL_UPSELL_V2'
         placements_liquidity_automatic_guidance = 'PLACEMENTS_LIQUIDITY_AUTOMATIC_GUIDANCE'
+        post_adoption_budget_scaling = 'POST_ADOPTION_BUDGET_SCALING'
         predictive_creative_limited = 'PREDICTIVE_CREATIVE_LIMITED'
         predictive_creative_limited_hourly = 'PREDICTIVE_CREATIVE_LIMITED_HOURLY'
         preparing_status = 'PREPARING_STATUS'
         product_extensions_guidance = 'PRODUCT_EXTENSIONS_GUIDANCE'
+        product_extensions_image_to_carousel = 'PRODUCT_EXTENSIONS_IMAGE_TO_CAROUSEL'
         product_set_boosting = 'PRODUCT_SET_BOOSTING'
         promo_ads_upsell_guidance = 'PROMO_ADS_UPSELL_GUIDANCE'
         purchase_optimization = 'PURCHASE_OPTIMIZATION'
@@ -329,6 +351,7 @@ class RecommendationType:
         reels_pc_recommendation_v2 = 'REELS_PC_RECOMMENDATION_V2'
         reels_performant_creative = 'REELS_PERFORMANT_CREATIVE'
         reels_placement = 'REELS_PLACEMENT'
+        resolve_unavailable_event_optimization = 'RESOLVE_UNAVAILABLE_EVENT_OPTIMIZATION'
         revert = 'REVERT'
         review_creative_duplicated_rejected_ads = 'REVIEW_CREATIVE_DUPLICATED_REJECTED_ADS'
         sabr_default_duration = 'SABR_DEFAULT_DURATION'
@@ -341,6 +364,7 @@ class RecommendationType:
         scale_good_campaign_v2_duplication = 'SCALE_GOOD_CAMPAIGN_V2_DUPLICATION'
         scale_good_ctx_campaign = 'SCALE_GOOD_CTX_CAMPAIGN'
         scale_good_ctx_campaigns_duplication = 'SCALE_GOOD_CTX_CAMPAIGNS_DUPLICATION'
+        scale_good_value_optimization_campaign = 'SCALE_GOOD_VALUE_OPTIMIZATION_CAMPAIGN'
         seasonal_campaigns = 'SEASONAL_CAMPAIGNS'
         semantic_based_audience_duplication = 'SEMANTIC_BASED_AUDIENCE_DUPLICATION'
         semantic_based_audience_expansion = 'SEMANTIC_BASED_AUDIENCE_EXPANSION'
@@ -361,11 +385,15 @@ class RecommendationType:
         site_extensions_guidance = 'SITE_EXTENSIONS_GUIDANCE'
         six_plus_manual_placements = 'SIX_PLUS_MANUAL_PLACEMENTS'
         six_plus_placements_duplication = 'SIX_PLUS_PLACEMENTS_DUPLICATION'
+        smart_default_value_rules = 'SMART_DEFAULT_VALUE_RULES'
+        smb_duplication = 'SMB_DUPLICATION'
         spend_limit = 'SPEND_LIMIT'
+        support_ctm_ads_with_customer_actions = 'SUPPORT_CTM_ADS_WITH_CUSTOMER_ACTIONS'
         syd_test_mode = 'SYD_TEST_MODE'
         tailored_lead_ad_campaign = 'TAILORED_LEAD_AD_CAMPAIGN'
         tailored_messages_campaign = 'TAILORED_MESSAGES_CAMPAIGN'
         targeting_creative_fragmentation = 'TARGETING_CREATIVE_FRAGMENTATION'
+        threeco_web_plus_app_aplusd = 'THREECO_WEB_PLUS_APP_APLUSD'
         threeco_web_plus_app_upsell = 'THREECO_WEB_PLUS_APP_UPSELL'
         tla_creation_package = 'TLA_CREATION_PACKAGE'
         top_adsets_with_ads_under_cap = 'TOP_ADSETS_WITH_ADS_UNDER_CAP'
@@ -378,7 +406,9 @@ class RecommendationType:
         uneconomical_ads_throttling = 'UNECONOMICAL_ADS_THROTTLING'
         unified_inbox = 'UNIFIED_INBOX'
         unused_budget = 'UNUSED_BUDGET'
+        upgrade_duration_settings_for_duplication = 'UPGRADE_DURATION_SETTINGS_FOR_DUPLICATION'
         upper_funnel_to_lead_instant_form = 'UPPER_FUNNEL_TO_LEAD_INSTANT_FORM'
+        upsell_soft_opt_out_to_non_aplus_p = 'UPSELL_SOFT_OPT_OUT_TO_NON_APLUS_P'
         value_co_campaigns_low_purchase_dq = 'VALUE_CO_CAMPAIGNS_LOW_PURCHASE_DQ'
         value_diagnostics_guidance = 'VALUE_DIAGNOSTICS_GUIDANCE'
         value_optimization_goal = 'VALUE_OPTIMIZATION_GOAL'
@@ -393,13 +423,15 @@ class RecommendationType:
         wa_messaging_partners_v2 = 'WA_MESSAGING_PARTNERS_V2'
         website_and_calls_upsell = 'WEBSITE_AND_CALLS_UPSELL'
         website_and_instant_form_l2 = 'WEBSITE_AND_INSTANT_FORM_L2'
+        website_to_messenger = 'WEBSITE_TO_MESSENGER'
         web_engaged_view_conversions = 'WEB_ENGAGED_VIEW_CONVERSIONS'
         wtwa_upsell_in_duplication = 'WTWA_UPSELL_IN_DUPLICATION'
         wtwa_upsell_in_syd_and_am_table = 'WTWA_UPSELL_IN_SYD_AND_AM_TABLE'
         yi_test = 'YI_TEST'
         zero_conversion = 'ZERO_CONVERSION'
         zero_impression = 'ZERO_IMPRESSION'
         zero_outcome_budget = 'ZERO_OUTCOME_BUDGET'
+        ziji_sgp_ugp_test = 'ZIJI_SGP_UGP_TEST'
 
     _field_types = {
         'actor_id': 'string',

facebook_business/adobjects/adaccountbusinessconstraints.py

@@ -29,6 +29,7 @@ def __init__(self, fbid=None, parent_id=None, api=None):
     class Field(AbstractObject.Field):
         audience_controls = 'audience_controls'
         campaigns_with_error = 'campaigns_with_error'
+        is_age_restriction_enabled = 'is_age_restriction_enabled'
         placement_controls = 'placement_controls'
         status = 'status'
 
@@ -50,6 +51,7 @@ def api_create(self, parent_id, fields=None, params=None, batch=None, success=No
     _field_types = {
         'audience_controls': 'Object',
         'campaigns_with_error': 'list<string>',
+        'is_age_restriction_enabled': 'bool',
         'placement_controls': 'Object',
         'status': 'Status',
     }

facebook_business/adobjects/adaccountdeliveryestimate.py

@@ -39,6 +39,7 @@ class OptimizationGoal:
         automatic_objective = 'AUTOMATIC_OBJECTIVE'
         conversations = 'CONVERSATIONS'
         derived_events = 'DERIVED_EVENTS'
+        engaged_page_views = 'ENGAGED_PAGE_VIEWS'
         engaged_users = 'ENGAGED_USERS'
         event_responses = 'EVENT_RESPONSES'
         impressions = 'IMPRESSIONS'

…/adobjects/productdaeventsamplesbatch.py …ts/adaccountmarketingmessagessettings.pyfacebook_business/adobjects/productdaeventsamplesbatch.py renamed to facebook_business/adobjects/adaccountmarketingmessagessettings.py facebook_business/adobjects/productdaeventsamplesbatch.py renamed to facebook_business/adobjects/adaccountmarketingmessagessettings.py

@@ -14,24 +14,20 @@
 pull request for this class.
 """
 
-class ProductDaEventSamplesBatch(
+class AdAccountMarketingMessagesSettings(
     AbstractObject,
 ):
 
     def __init__(self, api=None):
-        super(ProductDaEventSamplesBatch, self).__init__()
-        self._isProductDaEventSamplesBatch = True
+        super(AdAccountMarketingMessagesSettings, self).__init__()
+        self._isAdAccountMarketingMessagesSettings = True
         self._api = api
 
     class Field(AbstractObject.Field):
-        samples = 'samples'
-        time_start = 'time_start'
-        time_stop = 'time_stop'
+        whatsapp_activation_status = 'whatsapp_activation_status'
 
     _field_types = {
-        'samples': 'list<Object>',
-        'time_start': 'unsigned int',
-        'time_stop': 'unsigned int',
+        'whatsapp_activation_status': 'string',
     }
     @classmethod
     def _get_field_enum_info(cls):

facebook_business/adobjects/adaccountmatchedsearchapplicationsedgedata.py

@@ -48,6 +48,7 @@ class AppStore:
         fb_gameroom = 'FB_GAMEROOM'
         galaxy_store = 'GALAXY_STORE'
         google_play = 'GOOGLE_PLAY'
+        horizon_world = 'HORIZON_WORLD'
         instant_game = 'INSTANT_GAME'
         itunes = 'ITUNES'
         itunes_ipad = 'ITUNES_IPAD'
@@ -77,6 +78,7 @@ class StoresToFilter:
         fb_gameroom = 'FB_GAMEROOM'
         galaxy_store = 'GALAXY_STORE'
         google_play = 'GOOGLE_PLAY'
+        horizon_world = 'HORIZON_WORLD'
         instant_game = 'INSTANT_GAME'
         itunes = 'ITUNES'
         itunes_ipad = 'ITUNES_IPAD'

facebook_business/adobjects/adaccountoptimizationgoalsaemv2eligibility.py

@@ -35,6 +35,7 @@ class OptimizationGoal:
         automatic_objective = 'AUTOMATIC_OBJECTIVE'
         conversations = 'CONVERSATIONS'
         derived_events = 'DERIVED_EVENTS'
+        engaged_page_views = 'ENGAGED_PAGE_VIEWS'
         engaged_users = 'ENGAGED_USERS'
         event_responses = 'EVENT_RESPONSES'
         impressions = 'IMPRESSIONS'