facebookbusiness 19.0.0 → 19.0.2

data/lib/facebook_ads/ad_objects/server_side/action_source.rb

@@ -41,6 +41,9 @@ module FacebookAds
 			# Conversion happened automatically, for example, a subscription renewal that's set on auto-pay each month.
 			'system_generated',
 
+			# Conversion happened through a business messaging channel, such as WhatsApp or Instagram Direct.
+			'business_messaging',
+
 			# Conversion happened in a way that is not listed.
 			'other'
 		]

data/lib/facebook_ads/ad_objects/server_side/event.rb

@@ -75,6 +75,9 @@ module FacebookAds
       # Only used for the Advanced Measurement API in the Advanced Analytics product
       attr_accessor :advanced_measurement_table
 
+      # Messaging channel for the event
+      attr_accessor :messaging_channel
+
       # @param [String] event_name
       # @param [int] event_time
       # @param [String] event_source_url
@@ -88,6 +91,7 @@ module FacebookAds
       # @param [int] data_processing_options_state
       # @param String action_source
       # @param [String] advanced_measurement_table
+      # @param [String] messaging_channel
       def initialize(event_name: nil,
                      event_time: nil,
                      event_source_url: nil,
@@ -100,7 +104,9 @@ module FacebookAds
                      data_processing_options_country: nil,
                      data_processing_options_state: nil,
                      action_source: nil,
-                     advanced_measurement_table: nil)
+                     advanced_measurement_table: nil,
+                     messaging_channel: nil
+                     )
 
         unless event_name.nil?
           self.event_name = event_name
@@ -141,6 +147,9 @@ module FacebookAds
         unless advanced_measurement_table.nil?
           self.advanced_measurement_table = advanced_measurement_table
         end
+        unless messaging_channel.nil?
+          self.messaging_channel = messaging_channel
+        end
       end
 
       # build the object using the input hash
@@ -202,6 +211,10 @@ module FacebookAds
         if attributes.has_key?(:'advanced_measurement_table')
           self.advanced_measurement_table = attributes[:'advanced_measurement_table']
         end
+
+        if attributes.has_key?(:'messaging_channel')
+          self.messaging_channel = attributes[:'messaging_channel']
+        end
       end
 
       # Show invalid properties with the reasons. Usually used together with valid?
@@ -249,6 +262,7 @@ module FacebookAds
             data_processing_options_state == o.data_processing_options_state &&
             action_source == o.action_source &&
             advanced_measurement_table == o.advanced_measurement_table
+            messaging_channel == o.messaging_channel
       end
 
       # @see the `==` method
@@ -262,7 +276,7 @@ module FacebookAds
         [
           event_name, event_time, event_source_url, opt_out, event_id, user_data, custom_data, app_data,
           data_processing_options, data_processing_options_country, data_processing_options_state,
-          action_source, advanced_measurement_table,
+          action_source, advanced_measurement_table, messaging_channel,
         ].hash
       end
 
@@ -307,6 +321,9 @@ module FacebookAds
         unless advanced_measurement_table.nil?
           hash['advanced_measurement_table'] = advanced_measurement_table
         end
+        unless messaging_channel.nil?
+          hash['messaging_channel'] = messaging_channel
+        end
         hash.to_s
       end
 
@@ -356,6 +373,9 @@ module FacebookAds
         unless advanced_measurement_table.nil?
           hash['advanced_measurement_table'] = advanced_measurement_table
         end
+        unless messaging_channel.nil?
+          hash['messaging_channel'] = messaging_channel
+        end
         hash
       end
 

data/lib/facebook_ads/ad_objects/server_side/messaging_channel.rb

@@ -0,0 +1,27 @@
+# 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.
+
+module FacebookAds
+	module ServerSide
+		MessagingChannel = Set[
+
+			# Conversion happened on WhatsApp.
+			'whatsapp',
+		]
+	end
+end

data/lib/facebook_ads/ad_objects/server_side/user_data.rb

@@ -236,6 +236,11 @@ module FacebookAds
         @madids = [madid]
       end
 
+      # ctwaClid ID of a conversation that was started on WhatsApp
+      attr_accessor :ctwa_clid
+
+      # pageId ID of the page that the ad is associated with
+      attr_accessor :page_id
 
       #UserData is a set of identifiers Facebook can use for targeted attribution
       # @param [String] email
@@ -276,13 +281,16 @@ module FacebookAds
       # @param [Array<String>] anon_ids
       # @param [String] madid
       # @param [Array<String>] madids
+      # @param [String] ctwa_clid
+      # @param [String] page_id
       def initialize(email: nil, emails: nil, phone: nil, phones: nil, gender: nil, genders: nil,
                      date_of_birth: nil, dates_of_birth: nil, last_name: nil, last_names: nil,
                      first_name: nil, first_names: nil, city: nil, cities: nil, state: nil, states: nil,
                      country_code: nil, country_codes: nil, zip_code: nil, zip_codes: nil,
                      external_id: nil, external_ids: nil, client_ip_address: nil,
                      client_user_agent: nil, fbc: nil, fbp: nil, subscription_id: nil, lead_id: nil,
-                     f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil, anon_id: nil, anon_ids: nil, madid:nil, madids: nil)
+                     f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil, anon_id: nil, anon_ids: nil, madid:nil, madids: nil,
+                     ctwa_clid: nil, page_id: nil)
         validate_constructor_values(emails, email, 'emails', 'email')
         validate_constructor_values(phones, phone, 'phones', 'phone')
         validate_constructor_values(genders, gender, 'genders', 'gender')
@@ -409,6 +417,12 @@ module FacebookAds
         unless madids.nil?
           self.madids = madids
         end
+        unless ctwa_clid.nil?
+          self.ctwa_clid = ctwa_clid
+        end
+        unless page_id.nil?
+          self.page_id = page_id
+        end
       end
 
       # build the object using the input hash
@@ -540,6 +554,14 @@ module FacebookAds
         elsif attributes.has_key?(:'madid')
           self.madids = [attributes[:'madid']]
         end
+
+        if attributes.has_key?(:'ctwa_clid')
+          self.ctwa_clid = [attributes[:'ctwa_clid']]
+        end
+
+        if attributes.has_key?(:'page_id')
+          self.page_id = [attributes[:'page_id']]
+        end
       end
 
       # Checks equality by comparing each attribute.
@@ -570,7 +592,9 @@ module FacebookAds
             dobm == o.dobm &&
             doby == o.doby &&
             anon_ids == o.anon_ids &&
-            madids == o.madids
+            madids == o.madids &&
+            ctwa_clid == ctwa_clid &&
+            page_id == page_id
       end
 
       # @see the `==` method
@@ -606,7 +630,9 @@ module FacebookAds
             dobm,
             doby,
             anon_ids,
-            madids
+            madids,
+            ctwa_clid,
+            page_id
         ].hash
 
       end
@@ -690,6 +716,12 @@ module FacebookAds
         unless madids.nil?
           hash['madids'] = madids
         end
+        unless ctwa_clid.nil?
+          hash['ctwa_clid'] = ctwa_clid
+        end
+        unless page_id.nil?
+          hash['page_id'] = page_id
+        end
         hash.to_s
       end
 
@@ -772,6 +804,12 @@ module FacebookAds
         unless madid.nil?
           hash['madid'] = madids
         end
+        unless ctwa_clid.nil?
+          hash['ctwa_clid'] = ctwa_clid
+        end
+        unless page_id.nil?
+          hash['page_id'] =  page_id
+        end
         hash.select{|k, v| !v.nil?}
       end
 

data/lib/facebook_ads/ad_objects/shop.rb

@@ -15,6 +15,7 @@ module FacebookAds
 
   class Shop < AdObject
 
+    field :commerce_merchant_settings, 'CommerceMerchantSettings'
     field :fb_sales_channel, 'object'
     field :id, 'string'
     field :ig_sales_channel, 'object'

data/lib/facebook_ads/ad_objects/targeting.rb

@@ -28,6 +28,7 @@ module FacebookAds
     field :adgroup_id, 'string'
     field :age_max, 'int'
     field :age_min, 'int'
+    field :age_range, { list: 'int' }
     field :alternate_auto_targeting_option, 'string'
     field :app_install_state, 'string'
     field :audience_network_positions, { list: 'string' }
@@ -105,6 +106,7 @@ module FacebookAds
     field :regions, { list: 'IdName' }
     field :relationship_statuses, { list: 'int' }
     field :site_category, { list: 'string' }
+    field :targeting_automation, 'TargetingAutomation'
     field :targeting_optimization, 'string'
     field :targeting_relaxation_types, 'TargetingRelaxation'
     field :user_adclusters, { list: 'IdName' }

data/lib/facebook_ads/ad_objects/targeting_automation.rb

@@ -0,0 +1,27 @@
+# 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 TargetingAutomation < AdObject
+
+    field :advantage_audience, 'int'
+    field :shared_audiences, 'int'
+    field :value_expression, 'int'
+    has_no_id
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

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

@@ -48,6 +48,7 @@ module FacebookAds
     field :health_status, 'WhatsAppBusinessHealthStatusForMessageSend'
     field :id, 'string'
     field :is_enabled_for_insights, 'bool'
+    field :linked_commerce_account, 'CommerceMerchantSettings'
     field :message_template_namespace, 'string'
     field :name, 'string'
     field :on_behalf_of_business_info, 'object'
@@ -140,6 +141,8 @@ module FacebookAds
         api.has_param :components, { list: 'hash' }
         api.has_param :cta_url_link_tracking_opted_out, 'bool'
         api.has_param :language, 'string'
+        api.has_param :library_template_button_inputs, { list: 'hash' }
+        api.has_param :library_template_name, 'string'
         api.has_param :message_send_ttl_seconds, 'int'
         api.has_param :name, 'string'
         api.has_param :sub_category, { enum: -> { WhatsAppBusinessAccount::SUB_CATEGORY }}

data/lib/facebook_ads/ad_objects/whats_app_business_partner_client_verification_submission.rb

@@ -0,0 +1,30 @@
+# 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 WhatsAppBusinessPartnerClientVerificationSubmission < AdObject
+
+    field :client_business_id, 'string'
+    field :id, 'string'
+    field :rejection_reasons, { list: 'string' }
+    field :submitted_info, 'object'
+    field :submitted_time, 'datetime'
+    field :update_time, 'datetime'
+    field :verification_status, 'string'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 19.0.0
+  version: 19.0.2
 platform: ruby
 authors:
 - Facebook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-24 00:00:00.000000000 Z
+date: 2024-03-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -271,7 +271,10 @@ files:
 - lib/facebook_ads/ad_objects/ad_account_tracking_data.rb
 - lib/facebook_ads/ad_objects/ad_account_user.rb
 - lib/facebook_ads/ad_objects/ad_activity.rb
+- lib/facebook_ads/ad_objects/ad_asset_body.rb
+- lib/facebook_ads/ad_objects/ad_asset_call_to_action_type.rb
 - lib/facebook_ads/ad_objects/ad_asset_customization_rule_customization_spec.rb
+- lib/facebook_ads/ad_objects/ad_asset_description.rb
 - lib/facebook_ads/ad_objects/ad_asset_feed_additional_data.rb
 - lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb
 - lib/facebook_ads/ad_objects/ad_asset_feed_spec_asset_customization_rule.rb
@@ -288,9 +291,13 @@ files:
 - lib/facebook_ads/ad_objects/ad_asset_feed_spec_link_url.rb
 - lib/facebook_ads/ad_objects/ad_asset_feed_spec_title.rb
 - lib/facebook_ads/ad_objects/ad_asset_feed_spec_video.rb
+- lib/facebook_ads/ad_objects/ad_asset_image.rb
+- lib/facebook_ads/ad_objects/ad_asset_link_url.rb
 - lib/facebook_ads/ad_objects/ad_asset_message_extensions.rb
 - lib/facebook_ads/ad_objects/ad_asset_onsite_destinations.rb
 - lib/facebook_ads/ad_objects/ad_asset_target_rule_targeting.rb
+- lib/facebook_ads/ad_objects/ad_asset_title.rb
+- lib/facebook_ads/ad_objects/ad_asset_video.rb
 - lib/facebook_ads/ad_objects/ad_async_request.rb
 - lib/facebook_ads/ad_objects/ad_async_request_set.rb
 - lib/facebook_ads/ad_objects/ad_async_request_set_notification_result.rb
@@ -332,7 +339,9 @@ files:
 - lib/facebook_ads/ad_objects/ad_creative_platform_customization.rb
 - lib/facebook_ads/ad_objects/ad_creative_portrait_customizations.rb
 - lib/facebook_ads/ad_objects/ad_creative_post_click_configuration.rb
+- lib/facebook_ads/ad_objects/ad_creative_promotion_metadata_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_recommender_settings.rb
+- lib/facebook_ads/ad_objects/ad_creative_site_links_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_sourcing_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_static_fallback_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_template_url_spec.rb
@@ -388,6 +397,7 @@ files:
 - lib/facebook_ads/ad_objects/age_range.rb
 - lib/facebook_ads/ad_objects/agency_client_declaration.rb
 - lib/facebook_ads/ad_objects/album.rb
+- lib/facebook_ads/ad_objects/analytics_segment.rb
 - lib/facebook_ads/ad_objects/android_app_link.rb
 - lib/facebook_ads/ad_objects/app_request.rb
 - lib/facebook_ads/ad_objects/app_request_former_recipient.rb
@@ -403,6 +413,8 @@ files:
 - lib/facebook_ads/ad_objects/avatar_profile_picture.rb
 - lib/facebook_ads/ad_objects/brand_request.rb
 - lib/facebook_ads/ad_objects/brand_safety_block_list_usage.rb
+- lib/facebook_ads/ad_objects/branded_content_shadow_ig_media_id.rb
+- lib/facebook_ads/ad_objects/branded_content_shadow_ig_user_id.rb
 - lib/facebook_ads/ad_objects/broad_targeting_categories.rb
 - lib/facebook_ads/ad_objects/business.rb
 - lib/facebook_ads/ad_objects/business_ad_account_request.rb
@@ -523,6 +535,7 @@ files:
 - 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
@@ -586,7 +599,6 @@ files:
 - lib/facebook_ads/ad_objects/open_graph_context.rb
 - lib/facebook_ads/ad_objects/outcome_prediction_point.rb
 - lib/facebook_ads/ad_objects/page.rb
-- lib/facebook_ads/ad_objects/page_about_story.rb
 - lib/facebook_ads/ad_objects/page_about_story_composed_block.rb
 - lib/facebook_ads/ad_objects/page_about_story_composed_block_entity_ranges.rb
 - lib/facebook_ads/ad_objects/page_about_story_composed_block_inline_style.rb
@@ -684,6 +696,7 @@ files:
 - lib/facebook_ads/ad_objects/server_side/http_method.rb
 - lib/facebook_ads/ad_objects/server_side/http_service_interface.rb
 - lib/facebook_ads/ad_objects/server_side/http_util.rb
+- lib/facebook_ads/ad_objects/server_side/messaging_channel.rb
 - lib/facebook_ads/ad_objects/server_side/user_data.rb
 - lib/facebook_ads/ad_objects/server_side/util.rb
 - lib/facebook_ads/ad_objects/shadow_ig_hashtag.rb
@@ -699,6 +712,7 @@ files:
 - lib/facebook_ads/ad_objects/system_user.rb
 - lib/facebook_ads/ad_objects/tab.rb
 - lib/facebook_ads/ad_objects/targeting.rb
+- lib/facebook_ads/ad_objects/targeting_automation.rb
 - lib/facebook_ads/ad_objects/targeting_dynamic_rule.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location.rb
 - lib/facebook_ads/ad_objects/targeting_geo_location_city.rb
@@ -754,6 +768,7 @@ files:
 - lib/facebook_ads/ad_objects/whats_app_business_account.rb
 - lib/facebook_ads/ad_objects/whats_app_business_health_status.rb
 - lib/facebook_ads/ad_objects/whats_app_business_health_status_for_message_send.rb
+- lib/facebook_ads/ad_objects/whats_app_business_partner_client_verification_submission.rb
 - lib/facebook_ads/ad_objects/whats_app_business_pre_verified_phone_number.rb
 - lib/facebook_ads/ad_objects/whats_app_business_profile.rb
 - lib/facebook_ads/ad_objects/windows_app_link.rb