facebookbusiness 19.0.1 → 19.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae2b94512b194b67baf6a533a9eca42dd8980741aa60d7d2ed742e0b609e5e26
-  data.tar.gz: c0af925a51c8d5c19cb311648859d095f5d316b019875788a56f85a0d62e4246
+  metadata.gz: 486381fb8eee188c15334c7c780601dc0db1b6ee97f874744042daa84872ddda
+  data.tar.gz: b1ec8da0174c26f76adcd66f52d3c3a9286db4e8b8b4e3626bfb817f677cb6a9
 SHA512:
-  metadata.gz: dbd426ecabf5236e89b805bc928909f1457b1b78255fcbe54dd5e2b82213c38c5f40e8e4e1d3c8d7f477bf56fee0b8c39a057b8793a4c13dbea5189da78f05fd
-  data.tar.gz: 251bfa797537c91d9451f28bb9103f9336283e148af1eccb63c0bcc480600a065211147d2aa4ef819efd24a57a5214ff1794e08a356415a6084dbcfe1eb5b25e
+  metadata.gz: effca5a73c1ced5b59d8b085fc13bac37f6ecfff84f627bc746385ab2eedf12010df8b3b9e1b2fc0f7facb95265526cf9a48360cfefcc8aa749d548ddb8f4bce
+  data.tar.gz: '058bf162289091bdb95bd433784b002f1463d5132f4d55b48f3c954a84bf044c7a10db27e3a278c0dc94934eba40e46cb8bf53a6a05b4b51bb1a97223b02b417'

data/lib/facebook_ads/ad_objects/ad.rb

@@ -64,7 +64,7 @@ module FacebookAds
       "last_week_mon_sun",
       "last_week_sun_sat",
       "last_year",
-      "lifetime",
+      "maximum",
       "this_month",
       "this_quarter",
       "this_week_mon_today",

data/lib/facebook_ads/ad_objects/ad_account.rb

@@ -103,6 +103,7 @@ module FacebookAds
       "AUTOMOTIVE_MODEL",
       "DESTINATION",
       "FLIGHT",
+      "GENERIC",
       "HOME_LISTING",
       "HOTEL",
       "JOB",
@@ -122,6 +123,7 @@ module FacebookAds
       "CLAIM",
       "CUSTOM",
       "ENGAGEMENT",
+      "EXCLUSION",
       "FOX",
       "LOOKALIKE",
       "MANAGED",
@@ -151,6 +153,7 @@ module FacebookAds
     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'
@@ -582,7 +585,6 @@ module FacebookAds
         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'
@@ -686,6 +688,10 @@ module FacebookAds
       end
     end
 
+    has_edge :audience_funnel do |edge|
+      edge.get
+    end
+
     has_edge :block_list_drafts do |edge|
       edge.post 'AdAccount' do |api|
         api.has_param :publisher_urls_file, 'file'
@@ -763,6 +769,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :cpa_guidance do |edge|
+      edge.get
+    end
+
     has_edge :customaudiences do |edge|
       edge.get 'CustomAudience' do |api|
         api.has_param :business_id, 'string'
@@ -1114,6 +1124,8 @@ 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 }}
@@ -1180,7 +1192,7 @@ module FacebookAds
       end
     end
 
-    has_edge :value_adjustment_rule_persona_groups do |edge|
+    has_edge :value_adjustment_rule_collections do |edge|
       edge.get
     end
 

data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb

@@ -41,6 +41,8 @@ module FacebookAds
       "APP_AEM_V2_INSTALLATION_PROMOTION",
       "ASC_BUDGET_OPTIMIZATION",
       "ASC_BUDGET_OPTIMIZATION_PFR",
+      "ASC_CREATION_PACKAGE",
+      "ASC_FRAGMENTATION_V2",
       "ASPECT_RATIO",
       "ATLEAST_6_PLACEMENTS",
       "AUCTION_OVERLAP",
@@ -58,14 +60,17 @@ module FacebookAds
       "CAPI_PERFORMANCE_MATCH_KEY",
       "CAPI_PERFORMANCE_MATCH_KEY_V2",
       "CASH_REWARDS_OPT_IN",
+      "CONNECTED_SOURCES",
       "CONNECT_FACEBOOK_PAGE_TO_INSTAGRAM",
       "CONNECT_FACEBOOK_PAGE_TO_WHATSAPP",
+      "CONVERSION_LEAD_ADS",
       "COST_GOAL",
       "COST_GOAL_BUDGET_LIMITED",
       "COST_GOAL_CPA_LIMITED",
       "COST_PER_RESULT",
       "CREATION_PACKAGE_UPGRADE_TO_ASC",
       "CREATION_PACKAGE_UPGRADE_TO_TLA",
+      "CREATION_PACKAGE_UPGRADE_TO_TMC",
       "CREATIVE_BADGE",
       "CREATIVE_DIVERSITY",
       "CREATIVE_FATIGUE",
@@ -75,7 +80,10 @@ module FacebookAds
       "CREATOR_ADS_PA_CONVERSION",
       "CTA",
       "CTX_BUDGET_OPTIMIZATION",
+      "CTX_CREATION_PACKAGE",
+      "CTX_GUIDANCE",
       "DA_ADVANTAGE_PLUS_CREATIVE_INFO_LABELS",
+      "DA_DUPLICATION_PRODUCT_TAGS",
       "DEAD_LINK",
       "DYNAMIC_ADVANTAGE_CAMPAIGN_BUDGET",
       "ECOSYSTEM_BID_REDUCE_L1_CARDINALITY",
@@ -87,6 +95,7 @@ module FacebookAds
       "HIGH_COST",
       "HISTORICAL_BENCHMARK",
       "IG_MULTI_ADS",
+      "LEAD_ADS_GUIDANCE",
       "LEARNING_LIMITED",
       "LEARNING_PAUSE_FRICTION",
       "LEARNING_PHASE_BUDGET_EDITS",
@@ -105,6 +114,7 @@ module FacebookAds
       "PFR_L1_INLINE_MMT",
       "PREDICTIVE_CREATIVE_LIMITED",
       "PREDICTIVE_CREATIVE_LIMITED_HOURLY",
+      "PREPARING_STATUS",
       "RAPID_LEARNING_LIMITED",
       "RAPID_LEARNING_PHASE",
       "REELS_DUPLICATION_UPSELL",
@@ -120,6 +130,7 @@ module FacebookAds
       "SPEND_LIMIT",
       "SYD_TEST_MODE",
       "TAILORED_LEAD_AD_CAMPAIGN",
+      "TAILORED_MESSAGES_CAMPAIGN",
       "TOP_ADSETS_WITH_ADS_UNDER_CAP",
       "TOP_CAMPAIGNS_WITH_ADS_UNDER_CAP",
       "TWO_P_GUIDANCE_CARD_AAA",

data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb

@@ -396,6 +396,7 @@ module FacebookAds
       "location_categories",
       "location_cluster_ids",
       "location_expansion",
+      "marketing_message_channels",
       "marketing_message_targeting",
       "marketplace_product_categories",
       "messenger_positions",

data/lib/facebook_ads/ad_objects/ad_activity.rb

@@ -96,6 +96,7 @@ module FacebookAds
       "update_campaign_name",
       "update_campaign_run_status",
       "update_campaign_schedule",
+      "update_campaign_value_adjustment_rule",
       "update_delivery_type_cross_level_shift",
     ]
 

data/lib/facebook_ads/ad_objects/ad_asset_feed_additional_data.rb

@@ -20,6 +20,7 @@ module FacebookAds
     field :is_click_to_message, 'bool'
     field :multi_share_end_card, 'bool'
     field :page_welcome_message, 'string'
+    field :partner_app_welcome_message_flow_id, 'string'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb

@@ -17,15 +17,20 @@ module FacebookAds
     CALL_TO_ACTION_TYPES = [
       "ADD_TO_CART",
       "APPLY_NOW",
+      "ASK_ABOUT_SERVICES",
+      "ASK_FOR_MORE_INFO",
       "AUDIO_CALL",
+      "BOOK_A_CONSULTATION",
       "BOOK_NOW",
       "BOOK_TRAVEL",
       "BUY",
       "BUY_NOW",
       "BUY_TICKETS",
+      "BUY_VIA_MESSAGE",
       "CALL",
       "CALL_ME",
       "CALL_NOW",
+      "CHAT_WITH_US",
       "CONFIRM",
       "CONTACT",
       "CONTACT_US",
@@ -38,6 +43,7 @@ module FacebookAds
       "FOLLOW_NEWS_STORYLINE",
       "FOLLOW_PAGE",
       "FOLLOW_USER",
+      "GET_A_QUOTE",
       "GET_DIRECTIONS",
       "GET_OFFER",
       "GET_OFFER_VIEW",
@@ -53,6 +59,7 @@ module FacebookAds
       "LIKE_PAGE",
       "LISTEN_MUSIC",
       "LISTEN_NOW",
+      "MAKE_AN_APPOINTMENT",
       "MESSAGE_PAGE",
       "MOBILE_DOWNLOAD",
       "NO_BUTTON",
@@ -112,6 +119,7 @@ module FacebookAds
     field :message_extensions, { list: 'AdAssetMessageExtensions' }
     field :onsite_destinations, { list: 'AdAssetOnsiteDestinations' }
     field :optimization_type, 'string'
+    field :promotional_metadata, 'object'
     field :reasons_to_shop, 'bool'
     field :shops_bundle, 'bool'
     field :titles, { list: 'AdAssetFeedSpecTitle' }

data/lib/facebook_ads/ad_objects/ad_creative.rb

@@ -17,15 +17,20 @@ module FacebookAds
     CALL_TO_ACTION_TYPE = [
       "ADD_TO_CART",
       "APPLY_NOW",
+      "ASK_ABOUT_SERVICES",
+      "ASK_FOR_MORE_INFO",
       "AUDIO_CALL",
+      "BOOK_A_CONSULTATION",
       "BOOK_NOW",
       "BOOK_TRAVEL",
       "BUY",
       "BUY_NOW",
       "BUY_TICKETS",
+      "BUY_VIA_MESSAGE",
       "CALL",
       "CALL_ME",
       "CALL_NOW",
+      "CHAT_WITH_US",
       "CONFIRM",
       "CONTACT",
       "CONTACT_US",
@@ -38,6 +43,7 @@ module FacebookAds
       "FOLLOW_NEWS_STORYLINE",
       "FOLLOW_PAGE",
       "FOLLOW_USER",
+      "GET_A_QUOTE",
       "GET_DIRECTIONS",
       "GET_OFFER",
       "GET_OFFER_VIEW",
@@ -53,6 +59,7 @@ module FacebookAds
       "LIKE_PAGE",
       "LISTEN_MUSIC",
       "LISTEN_NOW",
+      "MAKE_AN_APPOINTMENT",
       "MESSAGE_PAGE",
       "MOBILE_DOWNLOAD",
       "NO_BUTTON",

data/lib/facebook_ads/ad_objects/ad_creative_features_spec.rb

@@ -16,8 +16,11 @@ module FacebookAds
   class AdCreativeFeaturesSpec < AdObject
 
     field :advantage_plus_creative, 'AdCreativeFeatureDetails'
+    field :app_highlights, 'AdCreativeFeatureDetails'
     field :audio, 'AdCreativeFeatureDetails'
     field :carousel_to_video, 'AdCreativeFeatureDetails'
+    field :catalog_feed_tag, 'AdCreativeFeatureDetails'
+    field :customize_product_recommendation, 'AdCreativeFeatureDetails'
     field :cv_transformation, 'AdCreativeFeatureDetails'
     field :description_automation, 'AdCreativeFeatureDetails'
     field :dha_optimization, 'AdCreativeFeatureDetails'
@@ -36,6 +39,7 @@ module FacebookAds
     field :product_metadata_automation, 'AdCreativeFeatureDetails'
     field :product_tags, 'AdCreativeFeatureDetails'
     field :profile_card, 'AdCreativeFeatureDetails'
+    field :site_extensions, 'AdCreativeFeatureDetails'
     field :standard_enhancements, 'AdCreativeFeatureDetails'
     field :standard_enhancements_catalog, 'AdCreativeFeatureDetails'
     field :text_generation, 'AdCreativeFeatureDetails'

data/lib/facebook_ads/ad_objects/ad_creative_link_data.rb

@@ -19,6 +19,7 @@ module FacebookAds
       "carousel_images_multi_items",
       "carousel_images_single_item",
       "carousel_slideshows",
+      "collection_video",
       "single_image",
     ]
 

data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb

@@ -17,15 +17,20 @@ module FacebookAds
     TYPE = [
       "ADD_TO_CART",
       "APPLY_NOW",
+      "ASK_ABOUT_SERVICES",
+      "ASK_FOR_MORE_INFO",
       "AUDIO_CALL",
+      "BOOK_A_CONSULTATION",
       "BOOK_NOW",
       "BOOK_TRAVEL",
       "BUY",
       "BUY_NOW",
       "BUY_TICKETS",
+      "BUY_VIA_MESSAGE",
       "CALL",
       "CALL_ME",
       "CALL_NOW",
+      "CHAT_WITH_US",
       "CONFIRM",
       "CONTACT",
       "CONTACT_US",
@@ -38,6 +43,7 @@ module FacebookAds
       "FOLLOW_NEWS_STORYLINE",
       "FOLLOW_PAGE",
       "FOLLOW_USER",
+      "GET_A_QUOTE",
       "GET_DIRECTIONS",
       "GET_OFFER",
       "GET_OFFER_VIEW",
@@ -53,6 +59,7 @@ module FacebookAds
       "LIKE_PAGE",
       "LISTEN_MUSIC",
       "LISTEN_NOW",
+      "MAKE_AN_APPOINTMENT",
       "MESSAGE_PAGE",
       "MOBILE_DOWNLOAD",
       "NO_BUTTON",

data/lib/facebook_ads/ad_objects/ad_creative_sourcing_spec.rb

@@ -18,6 +18,7 @@ module FacebookAds
     field :associated_product_set_id, 'string'
     field :promotion_metadata_spec, { list: 'AdCreativePromotionMetadataSpec' }
     field :site_links_spec, { list: 'AdCreativeSiteLinksSpec' }
+    field :source_url, 'string'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/ad_preview.rb

@@ -50,9 +50,11 @@ module FacebookAds
       "INSTANT_ARTICLE_RECIRCULATION_AD",
       "INSTANT_ARTICLE_STANDARD",
       "INSTREAM_BANNER_DESKTOP",
+      "INSTREAM_BANNER_FULLSCREEN_MOBILE",
       "INSTREAM_BANNER_IMMERSIVE_MOBILE",
       "INSTREAM_BANNER_MOBILE",
       "INSTREAM_VIDEO_DESKTOP",
+      "INSTREAM_VIDEO_FULLSCREEN_MOBILE",
       "INSTREAM_VIDEO_IMAGE",
       "INSTREAM_VIDEO_IMMERSIVE_MOBILE",
       "INSTREAM_VIDEO_MOBILE",
@@ -70,6 +72,7 @@ module FacebookAds
       "MOBILE_NATIVE",
       "RIGHT_COLUMN_STANDARD",
       "SUGGESTED_VIDEO_DESKTOP",
+      "SUGGESTED_VIDEO_FULLSCREEN_MOBILE",
       "SUGGESTED_VIDEO_IMMERSIVE_MOBILE",
       "SUGGESTED_VIDEO_MOBILE",
       "WATCH_FEED_HOME",

data/lib/facebook_ads/ad_objects/ad_set.rb

@@ -102,7 +102,7 @@ module FacebookAds
       "LAST_WEEK_MON_SUN",
       "LAST_WEEK_SUN_SAT",
       "LAST_YEAR",
-      "LIFETIME",
+      "MAXIMUM",
       "THIS_MONTH",
       "THIS_QUARTER",
       "THIS_WEEK_MON_TODAY",
@@ -233,6 +233,7 @@ module FacebookAds
     field :promoted_object, 'AdPromotedObject'
     field :recommendations, { list: 'AdRecommendation' }
     field :recurring_budget_semantics, 'bool'
+    field :regional_regulation_identities, 'object'
     field :review_feedback, 'string'
     field :rf_prediction_id, 'string'
     field :source_adset, 'AdSet'

data/lib/facebook_ads/ad_objects/ad_video.rb

@@ -115,6 +115,7 @@ module FacebookAds
       "MUSIC_CLIP_IN_AUDIO_DIGEST",
       "MUSIC_CLIP_IN_COMMENT",
       "MUSIC_CLIP_IN_LIGHTWEIGHT_STATUS",
+      "MUSIC_CLIP_IN_MSGR_NOTE",
       "MUSIC_CLIP_IN_POLL_OPTION",
       "MUSIC_CLIP_ON_DATING_PROFILE",
       "NEO_ASYNC_GAME_VIDEO",
@@ -364,7 +365,6 @@ module FacebookAds
     field :fun_fact_toastee_id, 'int'
     field :guide, { list: { list: 'int' } }
     field :guide_enabled, 'bool'
-    field :has_nickname, 'bool'
     field :holiday_card, 'string'
     field :initial_heading, 'int'
     field :initial_pitch, 'int'

data/lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb

@@ -23,6 +23,7 @@ module FacebookAds
     field :bsg, 'hash'
     field :city_community, 'hash'
     field :commerce, 'hash'
+    field :compromise, 'hash'
     field :daily_deals, 'hash'
     field :daily_deals_legacy, 'hash'
     field :dpa, 'hash'

data/lib/facebook_ads/ad_objects/ads_insights.rb

@@ -20,8 +20,12 @@ module FacebookAds
       "1d_view",
       "28d_click",
       "28d_view",
+      "28d_view_all_conversions",
+      "28d_view_first_conversion",
       "7d_click",
       "7d_view",
+      "7d_view_all_conversions",
+      "7d_view_first_conversion",
       "dda",
       "default",
       "skan_click",
@@ -40,6 +44,8 @@ module FacebookAds
       "action_video_sound",
       "action_video_type",
       "conversion_destination",
+      "matched_persona_id",
+      "matched_persona_name",
       "signal_source_bucket",
       "standard_event_content_type",
     ]
@@ -110,7 +116,7 @@ module FacebookAds
       "last_week_mon_sun",
       "last_week_sun_sat",
       "last_year",
-      "lifetime",
+      "maximum",
       "this_month",
       "this_quarter",
       "this_week_mon_today",
@@ -139,6 +145,8 @@ module FacebookAds
       "action_video_sound",
       "action_video_type",
       "conversion_destination",
+      "matched_persona_id",
+      "matched_persona_name",
       "signal_source_bucket",
       "standard_event_content_type",
     ]
@@ -232,6 +240,7 @@ module FacebookAds
     field :marketing_messages_cost_per_delivered, 'string'
     field :marketing_messages_cost_per_link_btn_click, 'string'
     field :marketing_messages_spend, 'string'
+    field :marketing_messages_website_purchase_values, 'string'
     field :mobile_app_purchase_roas, { list: 'AdsActionStats' }
     field :objective, 'string'
     field :optimization_goal, 'string'

data/lib/facebook_ads/ad_objects/ads_pixel.rb

@@ -183,9 +183,5 @@ module FacebookAds
       end
     end
 
-    has_edge :telemetry do |edge|
-      edge.post
-    end
-
   end
 end

data/lib/facebook_ads/ad_objects/album.rb

@@ -116,7 +116,6 @@ module FacebookAds
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'
-        api.has_param :scheduled_publish_time, 'int'
         api.has_param :spherical_metadata, 'hash'
         api.has_param :sponsor_id, 'string'
         api.has_param :sponsor_relationship, 'int'

data/lib/facebook_ads/ad_objects/application.rb

@@ -236,6 +236,7 @@ module FacebookAds
         api.has_param :page_id, 'int'
         api.has_param :page_scoped_user_id, 'int'
         api.has_param :receipt_data, 'string'
+        api.has_param :sdk_version, 'string'
         api.has_param :ud, 'hash'
         api.has_param :url_schemes, { list: 'string' }
         api.has_param :user_id, 'string'
@@ -424,13 +425,6 @@ module FacebookAds
       end
     end
 
-    has_edge :events do |edge|
-      edge.get 'Event' do |api|
-        api.has_param :include_canceled, 'bool'
-        api.has_param :type, { enum: -> { Event::TYPE }}
-      end
-    end
-
     has_edge :iap_purchases do |edge|
       edge.get do |api|
         api.has_param :order_id, 'string'

data/lib/facebook_ads/ad_objects/avatar.rb

@@ -23,6 +23,7 @@ module FacebookAds
       edge.get do |api|
         api.has_param :client_name, 'string'
         api.has_param :client_version, 'string'
+        api.has_param :config_id, 'string'
         api.has_param :force_generate, 'bool'
         api.has_param :platform, 'string'
         api.has_param :profile, 'string'

data/lib/facebook_ads/ad_objects/business.rb

@@ -996,7 +996,6 @@ module FacebookAds
         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'

data/lib/facebook_ads/ad_objects/campaign.rb

@@ -57,7 +57,7 @@ module FacebookAds
       "last_week_mon_sun",
       "last_week_sun_sat",
       "last_year",
-      "lifetime",
+      "maximum",
       "this_month",
       "this_quarter",
       "this_week_mon_today",

data/lib/facebook_ads/ad_objects/catalog_sub_vertical_list.rb

@@ -44,7 +44,6 @@ module FacebookAds
     field :local_service_business_item, 'object'
     field :local_service_business_restaurant, 'object'
     field :loyalty_offer, 'object'
-    field :meetup_space, 'object'
     field :nursery, 'object'
     field :printers_and_scanners, 'object'
     field :printers_scanners_and_fax_machines, 'object'

data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb

@@ -39,7 +39,6 @@ module FacebookAds
     field :supported_card_types, { list: 'string' }
     field :terms, 'string'
     field :terms_url_by_locale, { list: 'hash' }
-    field :whatsapp_channel, 'object'
     has_no_post
     has_no_delete
 
@@ -92,10 +91,6 @@ module FacebookAds
       end
     end
 
-    has_edge :seller_issues do |edge|
-      edge.get
-    end
-
     has_edge :setup_status do |edge|
       edge.get 'CommerceMerchantSettingsSetupStatus'
     end
@@ -122,12 +117,5 @@ module FacebookAds
       edge.get
     end
 
-    has_edge :whatsapp_channel do |edge|
-      edge.post do |api|
-        api.has_param :op, { enum: %w{ADD REMOVE }}
-        api.has_param :whatsapp_business_accounts, { list: 'string' }
-      end
-    end
-
   end
 end

data/lib/facebook_ads/ad_objects/commerce_order.rb

@@ -79,10 +79,10 @@ module FacebookAds
       end
     end
 
-    has_edge :fulfill_order do |edge|
+    has_edge :item_updates do |edge|
       edge.post 'CommerceOrder' do |api|
-        api.has_param :idempotency_key, 'string'
         api.has_param :items, { list: 'hash' }
+        api.has_param :merchant_order_reference, 'string'
       end
     end
 
@@ -155,5 +155,15 @@ module FacebookAds
       end
     end
 
+    has_edge :updates do |edge|
+      edge.post 'CommerceOrder' do |api|
+        api.has_param :cancel_amount, 'hash'
+        api.has_param :fulfill_amount, 'hash'
+        api.has_param :merchant_order_reference, 'string'
+        api.has_param :refund_amount, 'hash'
+        api.has_param :total_amount, 'hash'
+      end
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/custom_audience.rb

@@ -30,6 +30,7 @@ module FacebookAds
       "AUTOMOTIVE_MODEL",
       "DESTINATION",
       "FLIGHT",
+      "GENERIC",
       "HOME_LISTING",
       "HOTEL",
       "JOB",
@@ -55,6 +56,7 @@ module FacebookAds
       "CLAIM",
       "CUSTOM",
       "ENGAGEMENT",
+      "EXCLUSION",
       "FOX",
       "LOOKALIKE",
       "MANAGED",

data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb

@@ -44,6 +44,7 @@ module FacebookAds
       "INSTANT_ARTICLE_EVENTS",
       "LOOKALIKE_PLATFORM",
       "MAIL_CHIMP_EMAIL_HASHES",
+      "MARKETPLACE_LISTINGS",
       "MESSENGER_ONSITE_SUBSCRIPTION",
       "MOBILE_ADVERTISER_IDS",
       "MOBILE_APP_COMBINATION_EVENTS",

data/lib/facebook_ads/ad_objects/destination.rb

@@ -42,6 +42,7 @@ module FacebookAds
     field :price, 'string'
     field :price_change, 'string'
     field :sanitized_images, { list: 'string' }
+    field :tags, { list: 'string' }
     field :types, { list: 'string' }
     field :unit_price, 'object'
     field :url, 'string'

data/lib/facebook_ads/ad_objects/flight.rb

@@ -45,6 +45,7 @@ module FacebookAds
     field :origin_city, 'string'
     field :price, 'string'
     field :sanitized_images, { list: 'string' }
+    field :tags, { list: 'string' }
     field :unit_price, 'object'
     field :url, 'string'
     field :visibility, { enum: -> { VISIBILITY }}

data/lib/facebook_ads/ad_objects/funding_source_details.rb

@@ -16,6 +16,7 @@ module FacebookAds
   class FundingSourceDetails < AdObject
 
     field :coupon, 'FundingSourceDetailsCoupon'
+    field :coupons, { list: 'FundingSourceDetailsCoupon' }
     field :display_string, 'string'
     field :id, 'string'
     field :type, 'int'

data/lib/facebook_ads/ad_objects/funding_source_details_coupon.rb

@@ -16,6 +16,7 @@ module FacebookAds
   class FundingSourceDetailsCoupon < AdObject
 
     field :amount, 'int'
+    field :campaign_ids, { list: 'int' }
     field :currency, 'string'
     field :display_amount, 'string'
     field :expiration, 'datetime'

data/lib/facebook_ads/ad_objects/group.rb

@@ -169,6 +169,8 @@ module FacebookAds
         api.has_param :audience_exp, 'bool'
         api.has_param :backdated_time, 'datetime'
         api.has_param :backdated_time_granularity, { enum: -> { Post::BACKDATED_TIME_GRANULARITY }}
+        api.has_param :breaking_news, 'bool'
+        api.has_param :breaking_news_expiration, 'int'
         api.has_param :call_to_action, 'object'
         api.has_param :caption, 'string'
         api.has_param :child_attachments, { list: 'object' }
@@ -193,7 +195,6 @@ module FacebookAds
         api.has_param :formatting, { enum: -> { Post::FORMATTING }}
         api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
-        api.has_param :has_nickname, 'bool'
         api.has_param :height, 'int'
         api.has_param :holiday_card, 'string'
         api.has_param :home_checkin_city_id, 'object'
@@ -376,7 +377,6 @@ module FacebookAds
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'
-        api.has_param :scheduled_publish_time, 'int'
         api.has_param :spherical_metadata, 'hash'
         api.has_param :sponsor_id, 'string'
         api.has_param :sponsor_relationship, 'int'
@@ -435,7 +435,6 @@ module FacebookAds
         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'

data/lib/facebook_ads/ad_objects/hotel.rb

@@ -49,6 +49,7 @@ module FacebookAds
     field :sale_price, 'string'
     field :sanitized_images, { list: 'string' }
     field :star_rating, 'double'
+    field :tags, { list: 'string' }
     field :unit_price, 'object'
     field :url, 'string'
     field :visibility, { enum: -> { VISIBILITY }}

data/lib/facebook_ads/ad_objects/{page_commerce_eligibility.rb → ig_upcoming_event.rb}

@@ -13,13 +13,12 @@ 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 PageCommerceEligibility < AdObject
+  class IgUpcomingEvent < AdObject
 
-    field :offsite, 'object'
-    field :onsite, 'object'
-    has_no_id
-    has_no_get
-    has_no_post
+    field :end_time, 'datetime'
+    field :id, 'string'
+    field :start_time, 'datetime'
+    field :title, 'string'
     has_no_delete
 
   end

data/lib/facebook_ads/ad_objects/ig_user.rb

@@ -120,6 +120,7 @@ module FacebookAds
         api.has_param :product_tags, { list: 'hash' }
         api.has_param :share_to_feed, 'bool'
         api.has_param :thumb_offset, 'string'
+        api.has_param :upload_type, 'string'
         api.has_param :user_tags, { list: 'hash' }
         api.has_param :video_url, 'string'
       end

data/lib/facebook_ads/ad_objects/insights_result.rb

@@ -27,7 +27,7 @@ module FacebookAds
       "last_week_mon_sun",
       "last_week_sun_sat",
       "last_year",
-      "lifetime",
+      "maximum",
       "this_month",
       "this_quarter",
       "this_week_mon_today",
@@ -53,7 +53,7 @@ module FacebookAds
     field :name, 'string'
     field :period, 'string'
     field :title, 'string'
-    field :values, { list: 'object' }
+    field :values, { list: 'InsightsValue' }
     has_no_get
     has_no_post
     has_no_delete

data/lib/facebook_ads/ad_objects/{targeting_geo_location_location_expansion.rb → insights_value.rb}

@@ -13,9 +13,18 @@ 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 TargetingGeoLocationLocationExpansion < AdObject
+  class InsightsValue < AdObject
 
-    field :allowed, 'bool'
+    field :campaign_id, 'string'
+    field :end_time, 'datetime'
+    field :engagement_source, 'string'
+    field :message_type, 'string'
+    field :messaging_channel, 'string'
+    field :recurring_notifications_entry_point, 'string'
+    field :recurring_notifications_frequency, 'string'
+    field :recurring_notifications_topic, 'string'
+    field :start_time, 'datetime'
+    field :value, 'object'
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/instagram_user.rb

@@ -48,7 +48,12 @@ module FacebookAds
     end
 
     has_edge :upcoming_events do |edge|
-      edge.get
+      edge.get 'IgUpcomingEvent'
+      edge.post 'IgUpcomingEvent' do |api|
+        api.has_param :end_time, 'datetime'
+        api.has_param :start_time, 'datetime'
+        api.has_param :title, 'string'
+      end
     end
 
   end

data/lib/facebook_ads/ad_objects/local_service_business.rb

@@ -84,6 +84,7 @@ module FacebookAds
     field :retailer_category, 'string'
     field :sanitized_images, { list: 'string' }
     field :size, 'string'
+    field :tags, { list: 'string' }
     field :title, 'string'
     field :unit_price, 'object'
     field :url, 'string'

data/lib/facebook_ads/ad_objects/page.rb

@@ -298,6 +298,7 @@ module FacebookAds
       "awards",
       "bio",
       "birthday",
+      "calls",
       "category",
       "checkins",
       "company_overview",
@@ -362,6 +363,7 @@ module FacebookAds
       "page_upcoming_change",
       "parking",
       "payment_options",
+      "payment_request_update",
       "personal_info",
       "personal_interests",
       "phone",
@@ -373,6 +375,7 @@ module FacebookAds
       "publisher_subscriptions",
       "ratings",
       "registration",
+      "response_feedback",
       "send_cart",
       "standby",
       "user_action",
@@ -381,6 +384,14 @@ module FacebookAds
       "website",
     ]
 
+    ACTION = [
+      "SPAM",
+    ]
+
+    ACTION_TYPE = [
+      "REPORT_THREAD",
+    ]
+
 
     field :about, 'string'
     field :access_token, 'string'
@@ -397,6 +408,7 @@ module FacebookAds
     field :bio, 'string'
     field :birthday, 'string'
     field :booking_agent, 'string'
+    field :breaking_news_usage, 'object'
     field :built, 'string'
     field :business, 'object'
     field :can_checkin, 'bool'
@@ -450,6 +462,7 @@ module FacebookAds
     field :is_community_page, 'bool'
     field :is_eligible_for_branded_content, 'bool'
     field :is_eligible_for_disable_connect_ig_btn_for_non_page_admin_am_web, 'bool'
+    field :is_eligible_for_live_boosting_expansion, 'bool'
     field :is_messenger_bot_get_started_enabled, 'bool'
     field :is_messenger_platform_bot, 'bool'
     field :is_owned, 'bool'
@@ -683,10 +696,6 @@ module FacebookAds
       end
     end
 
-    has_edge :commerce_eligibility do |edge|
-      edge.get 'PageCommerceEligibility'
-    end
-
     has_edge :commerce_merchant_settings do |edge|
       edge.get 'CommerceMerchantSettings'
     end
@@ -808,6 +817,8 @@ module FacebookAds
         api.has_param :audience_exp, 'bool'
         api.has_param :backdated_time, 'datetime'
         api.has_param :backdated_time_granularity, { enum: -> { Page::BACKDATED_TIME_GRANULARITY }}
+        api.has_param :breaking_news, 'bool'
+        api.has_param :breaking_news_expiration, 'int'
         api.has_param :call_to_action, 'object'
         api.has_param :caption, 'string'
         api.has_param :child_attachments, { list: 'object' }
@@ -833,7 +844,6 @@ module FacebookAds
         api.has_param :formatting, { enum: -> { Page::FORMATTING }}
         api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
-        api.has_param :has_nickname, 'bool'
         api.has_param :height, 'int'
         api.has_param :holiday_card, 'string'
         api.has_param :home_checkin_city_id, 'object'
@@ -1397,6 +1407,14 @@ module FacebookAds
       end
     end
 
+    has_edge :thread_action do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :action, { enum: -> { Page::ACTION }}
+        api.has_param :action_type, { enum: -> { Page::ACTION_TYPE }}
+        api.has_param :user_id, 'hash'
+      end
+    end
+
     has_edge :thread_owner do |edge|
       edge.get 'PageThreadOwner' do |api|
         api.has_param :recipient, 'string'
@@ -1526,7 +1544,6 @@ module FacebookAds
         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'

data/lib/facebook_ads/ad_objects/product_catalog.rb

@@ -21,7 +21,6 @@ module FacebookAds
 
     VERTICAL = [
       "adoptable_pets",
-      "bookable",
       "commerce",
       "destinations",
       "flights",
@@ -33,7 +32,6 @@ module FacebookAds
       "local_service_businesses",
       "offer_items",
       "offline_commerce",
-      "ticketed_experiences",
       "transactable_items",
       "vehicles",
     ]
@@ -530,5 +528,15 @@ module FacebookAds
       end
     end
 
+    has_edge :version_items_batch do |edge|
+      edge.post 'ProductCatalog' do |api|
+        api.has_param :allow_upsert, 'bool'
+        api.has_param :item_type, 'string'
+        api.has_param :item_version, 'string'
+        api.has_param :requests, 'hash'
+        api.has_param :version, 'int'
+      end
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/product_catalog_diagnostic_group.rb

@@ -15,11 +15,20 @@ module FacebookAds
 
   class ProductCatalogDiagnosticGroup < AdObject
     AFFECTED_CHANNELS = [
-      "business_inbox_in_messenger",
+      "b2c_marketplace",
+      "c2c_marketplace",
+      "da",
+      "daily_deals",
+      "daily_deals_legacy",
+      "ig_product_tagging",
+      "marketplace",
+      "marketplace_ads_deprecated",
+      "marketplace_shops",
+      "mini_shops",
+      "offline_conversions",
       "shops",
-      "test_capability",
       "universal_checkout",
-      "us_marketplace",
+      "whatsapp",
     ]
 
     AFFECTED_ENTITY = [

data/lib/facebook_ads/ad_objects/product_item.rb

@@ -328,6 +328,7 @@ module FacebookAds
       "EMPTY_TITLE",
       "EXTERNAL_MERCHANT_ID_MISMATCH",
       "GENERIC_INVALID_FIELD",
+      "GROUPS_DISABLED_BY_USER",
       "HIDDEN_UNTIL_PRODUCT_LAUNCH",
       "IMAGE_FETCH_FAILED",
       "IMAGE_FETCH_FAILED_BAD_GATEWAY",

data/lib/facebook_ads/ad_objects/targeting_geo_location.rb

@@ -23,7 +23,6 @@ module FacebookAds
     field :geo_markets, { list: 'TargetingGeoLocationMarket' }
     field :large_geo_areas, { list: 'TargetingGeoLocationGeoEntities' }
     field :location_cluster_ids, { list: 'TargetingGeoLocationLocationCluster' }
-    field :location_expansion, 'TargetingGeoLocationLocationExpansion'
     field :location_types, { list: 'string' }
     field :medium_geo_areas, { list: 'TargetingGeoLocationGeoEntities' }
     field :metro_areas, { list: 'TargetingGeoLocationGeoEntities' }

data/lib/facebook_ads/ad_objects/user.rb

@@ -252,6 +252,8 @@ module FacebookAds
         api.has_param :audience_exp, 'bool'
         api.has_param :backdated_time, 'datetime'
         api.has_param :backdated_time_granularity, { enum: -> { Post::BACKDATED_TIME_GRANULARITY }}
+        api.has_param :breaking_news, 'bool'
+        api.has_param :breaking_news_expiration, 'int'
         api.has_param :call_to_action, 'object'
         api.has_param :caption, 'string'
         api.has_param :child_attachments, { list: 'object' }
@@ -276,7 +278,6 @@ module FacebookAds
         api.has_param :formatting, { enum: -> { Post::FORMATTING }}
         api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
-        api.has_param :has_nickname, 'bool'
         api.has_param :height, 'int'
         api.has_param :holiday_card, 'string'
         api.has_param :home_checkin_city_id, 'object'
@@ -532,7 +533,6 @@ module FacebookAds
         api.has_param :proxied_app_id, 'string'
         api.has_param :published, 'bool'
         api.has_param :qn, 'string'
-        api.has_param :scheduled_publish_time, 'int'
         api.has_param :spherical_metadata, 'hash'
         api.has_param :sponsor_id, 'string'
         api.has_param :sponsor_relationship, 'int'
@@ -615,7 +615,6 @@ module FacebookAds
         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'

data/lib/facebook_ads/ad_objects/whats_app_business_account.rb

@@ -33,7 +33,6 @@ module FacebookAds
     ]
 
     SUB_CATEGORY = [
-      "CUSTOM",
       "ORDER_DETAILS",
       "ORDER_STATUS",
     ]
@@ -80,7 +79,7 @@ module FacebookAds
 
     has_edge :conversation_analytics do |edge|
       edge.get do |api|
-        api.has_param :conversation_categories, { list: { enum: %w{AUTHENTICATION MARKETING MARKETING_OPTIMIZED_DELIVERY SERVICE UNKNOWN UTILITY }} }
+        api.has_param :conversation_categories, { list: { enum: %w{AUTHENTICATION AUTHENTICATION_INTERNATIONAL FIXED_TEMPLATE_NOTIFY MARKETING MARKETING_OPTIMIZED_DELIVERY SERVICE UNKNOWN UTILITY }} }
         api.has_param :conversation_directions, { list: { enum: %w{BUSINESS_INITIATED UNKNOWN USER_INITIATED }} }
         api.has_param :conversation_types, { list: { enum: %w{FREE_ENTRY_POINT FREE_TIER REGULAR UNKNOWN }} }
         api.has_param :country_codes, { list: 'string' }
@@ -181,6 +180,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :set_obo_mobility_intent do |edge|
+      edge.post
+    end
+
     has_edge :subscribed_apps do |edge|
       edge.delete
       edge.get

data/lib/facebook_ads/ad_objects/whats_app_business_partner_client_verification_submission.rb

@@ -14,14 +14,27 @@ module FacebookAds
   # pull request for this class.
 
   class WhatsAppBusinessPartnerClientVerificationSubmission < AdObject
+    REJECTION_REASONS = [
+      "ADDRESS_NOT_MATCHING",
+      "LEGAL_NAME_NOT_MATCHING",
+      "NONE",
+      "WEBSITE_NOT_MATCHING",
+    ]
+
+    VERIFICATION_STATUS = [
+      "APPROVED",
+      "FAILED",
+      "PENDING",
+    ]
+
 
     field :client_business_id, 'string'
     field :id, 'string'
-    field :rejection_reasons, { list: 'string' }
+    field :rejection_reasons, { list: { enum: -> { REJECTION_REASONS }} }
     field :submitted_info, 'object'
     field :submitted_time, 'datetime'
     field :update_time, 'datetime'
-    field :verification_status, 'string'
+    field :verification_status, { enum: -> { VERIFICATION_STATUS }}
     has_no_get
     has_no_post
     has_no_delete

data/lib/facebook_ads/version.rb

@@ -7,6 +7,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '19.0.1'
+  VERSION = '19.0.3'
   API_VERSION = '19.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 19.0.1
+  version: 19.0.3
 platform: ruby
 authors:
 - Facebook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-03-14 00:00:00.000000000 Z
+date: 2024-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -529,12 +529,14 @@ files:
 - lib/facebook_ads/ad_objects/ig_shopping_review_status.rb
 - lib/facebook_ads/ad_objects/ig_shopping_review_status_onsite_eligibility.rb
 - lib/facebook_ads/ad_objects/ig_shopping_review_status_reason_with_help_message.rb
+- lib/facebook_ads/ad_objects/ig_upcoming_event.rb
 - lib/facebook_ads/ad_objects/ig_user.rb
 - lib/facebook_ads/ad_objects/ig_video_copyright_check_matches_information.rb
 - lib/facebook_ads/ad_objects/ig_video_copyright_check_status.rb
 - lib/facebook_ads/ad_objects/igbc_ads_permission.rb
 - lib/facebook_ads/ad_objects/image_copyright.rb
 - lib/facebook_ads/ad_objects/insights_result.rb
+- lib/facebook_ads/ad_objects/insights_value.rb
 - lib/facebook_ads/ad_objects/instagram_carousel.rb
 - lib/facebook_ads/ad_objects/instagram_comment.rb
 - lib/facebook_ads/ad_objects/instagram_insights_result.rb
@@ -604,7 +606,6 @@ files:
 - lib/facebook_ads/ad_objects/page_call_to_action.rb
 - lib/facebook_ads/ad_objects/page_category.rb
 - lib/facebook_ads/ad_objects/page_change_proposal.rb
-- lib/facebook_ads/ad_objects/page_commerce_eligibility.rb
 - lib/facebook_ads/ad_objects/page_parking.rb
 - lib/facebook_ads/ad_objects/page_payment_options.rb
 - lib/facebook_ads/ad_objects/page_post.rb
@@ -719,7 +720,6 @@ files:
 - lib/facebook_ads/ad_objects/targeting_geo_location_electoral_district.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_geo_entities.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_location_cluster.rb
-- lib/facebook_ads/ad_objects/targeting_geo_location_location_expansion.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_market.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_place.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_political_district.rb