facebookbusiness 0.9.0.0 → 0.10.0.1

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

@@ -32,6 +32,21 @@ module FacebookAds
 			# RFC 2822 for email format
 			EMAIL_REGEX = /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\Z/i
 
+			# Normalizes the input array of strings given the field_type
+			# @param [Array<String>] input string array that needs to be normalized
+			# @param [String] field_type Type/Key for the value provided
+			# @return [Array<String>] Normalized values for the input and field_type.
+			def self.normalize_array(input_array, field_type)
+				return nil unless input_array.is_a?(Enumerable)
+				return nil if input_array.empty?
+				return nil unless input_array.all?{|value| value.is_a?(String)}
+
+				input_array
+					.map{|value| self.normalize(value, field_type)}
+					.to_set
+					.to_a
+			end
+
 			# Normalizes the input string given the field_type
 			# @param [String] input Input string that needs to be normalized
 			# @param [String] field_type Type/Key for the value provided
@@ -52,6 +67,8 @@ module FacebookAds
 				normalized_input = input;
 
 				case field_type
+				when 'action_source'
+					return normalize_action_source input
 				when 'country'
 					normalized_input = normalize_country input
 				when 'ct'
@@ -152,7 +169,7 @@ module FacebookAds
 			def self.normalize_email(email)
 
 				if EMAIL_REGEX.match(email) == nil
-					return ArgumentError, "Invalid email format for the passed email:' + email + '.Please check the passed email format."
+					raise ArgumentError, "Invalid email format for the passed email: '#{email}'. Please check the passed email format."
 				end
 
 				return email
@@ -290,6 +307,17 @@ module FacebookAds
 				delivery_category;
 			end
 
+			# Normalizes the input action_source and returns valid value (or throw exception if invalid).
+			def self.normalize_action_source(action_source)
+				unless FacebookAds::ServerSide::ActionSource.include?(action_source)
+					values = FacebookAds::ServerSide::ActionSource.to_a.join(',')
+					raise ArgumentError.new(
+						"Invalid action_source passed: #{action_source}. Please use one of the defined values: #{values}"
+					)
+				end
+
+				action_source
+			end
 		end
 	end
 end

data/lib/facebook_ads/ad_objects/system_user.rb

@@ -26,6 +26,24 @@ module FacebookAds
   # pull request for this class.
 
   class SystemUser < AdObject
+    ROLE = [
+      "ADMIN",
+      "ADS_RIGHTS_REVIEWER",
+      "DEFAULT",
+      "DEVELOPER",
+      "EMPLOYEE",
+      "FINANCE_ANALYST",
+      "FINANCE_EDIT",
+      "FINANCE_EDITOR",
+      "FINANCE_VIEW",
+      "MANAGE",
+      "PARTNER_CENTER_ADMIN",
+      "PARTNER_CENTER_ANALYST",
+      "PARTNER_CENTER_EDUCATION",
+      "PARTNER_CENTER_MARKETING",
+      "PARTNER_CENTER_OPERATIONS",
+    ]
+
 
     field :created_by, 'User'
     field :created_time, 'datetime'
@@ -33,6 +51,8 @@ module FacebookAds
     field :id, 'string'
     field :ip_permission, 'string'
     field :name, 'string'
+    field :role, { enum: -> { ROLE }}
+    field :system_user_id, 'int'
     has_no_post
     has_no_delete
 

data/lib/facebook_ads/ad_objects/targeting.rb

@@ -27,13 +27,11 @@ module FacebookAds
 
   class Targeting < AdObject
     DEVICE_PLATFORMS = [
-      "connected_tv",
       "desktop",
       "mobile",
     ]
 
     EFFECTIVE_DEVICE_PLATFORMS = [
-      "connected_tv",
       "desktop",
       "mobile",
     ]

data/lib/facebook_ads/ad_objects/unified_thread.rb

@@ -32,7 +32,6 @@ module FacebookAds
     field :id, 'string'
     field :is_subscribed, 'bool'
     field :link, 'string'
-    field :linked_group, 'Group'
     field :message_count, 'int'
     field :name, 'string'
     field :participants, 'object'

data/lib/facebook_ads/ad_objects/user.rb

@@ -49,14 +49,10 @@ module FacebookAds
 
 
     field :about, 'string'
-    field :address, 'Location'
-    field :admin_notes, { list: 'PageAdminNote' }
     field :age_range, 'AgeRange'
-    field :auth_method, 'string'
     field :birthday, 'string'
     field :cover, 'UserCoverPhoto'
     field :currency, 'Currency'
-    field :devices, { list: 'UserDevice' }
     field :education, { list: 'object' }
     field :email, 'string'
     field :favorite_athletes, { list: 'Experience' }
@@ -79,15 +75,12 @@ module FacebookAds
     field :locale, 'string'
     field :location, 'Page'
     field :meeting_for, { list: 'string' }
-    field :messenger_join_notifications_enabled, 'bool'
     field :middle_name, 'string'
     field :name, 'string'
     field :name_format, 'string'
     field :payment_pricepoints, 'PaymentPricepoints'
     field :political, 'string'
     field :profile_pic, 'string'
-    field :public_key, 'string'
-    field :published_timeline, 'bool'
     field :quotes, 'string'
     field :relationship_status, 'string'
     field :religion, 'string'
@@ -100,15 +93,17 @@ module FacebookAds
     field :timezone, 'double'
     field :token_for_business, 'string'
     field :updated_time, 'datetime'
-    field :user_storage_key, 'string'
-    field :username, 'string'
     field :verified, 'bool'
     field :video_upload_limits, 'VideoUploadLimits'
     field :website, 'string'
-    field :work, { list: 'object' }
 
     has_edge :access_tokens do |edge|
       edge.delete
+      edge.post 'User' do |api|
+        api.has_param :business_app, 'int'
+        api.has_param :page_id, 'string'
+        api.has_param :scope, { list: 'Permission' }
+      end
     end
 
     has_edge :accounts do |edge|
@@ -511,8 +506,8 @@ module FacebookAds
       end
     end
 
-    has_edge :owned_product_catalogs do |edge|
-      edge.get 'ProductCatalog'
+    has_edge :payment_transactions do |edge|
+      edge.get 'PaymentEnginePayment'
     end
 
     has_edge :permissions do |edge|
@@ -599,6 +594,17 @@ module FacebookAds
       end
     end
 
+    has_edge :posts do |edge|
+      edge.get 'Post' do |api|
+        api.has_param :include_hidden, 'bool'
+        api.has_param :q, 'string'
+        api.has_param :show_expired, 'bool'
+        api.has_param :since, 'datetime'
+        api.has_param :until, 'datetime'
+        api.has_param :with, 'string'
+      end
+    end
+
     has_edge :rich_media_documents do |edge|
       edge.get 'Canvas' do |api|
         api.has_param :query, 'string'
@@ -620,7 +626,6 @@ module FacebookAds
         api.has_param :animated_effect_id, 'int'
         api.has_param :application_id, 'string'
         api.has_param :asked_fun_fact_prompt_id, 'int'
-        api.has_param :attribution_app_id, 'string'
         api.has_param :audio_story_wave_animation_handle, 'string'
         api.has_param :composer_entry_picker, 'string'
         api.has_param :composer_entry_point, 'string'

data/lib/facebook_ads/ad_objects/vehicle.rb

@@ -26,6 +26,15 @@ module FacebookAds
   # pull request for this class.
 
   class Vehicle < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
     AVAILABILITY = [
       "AVAILABLE",
       "NOT_AVAILABLE",
@@ -127,6 +136,7 @@ module FacebookAds
     field :features, { list: 'object' }
     field :fuel_type, 'string'
     field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
     field :images, { list: 'string' }
     field :interior_color, 'string'
     field :legal_disclosure_impressum_url, 'string'
@@ -152,5 +162,13 @@ module FacebookAds
     field :year, 'int'
     has_no_delete
 
+    has_edge :augmented_realities_metadata do |edge|
+      edge.get
+    end
+
+    has_edge :videos_metadata do |edge|
+      edge.get
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/vehicle_offer.rb

@@ -26,6 +26,15 @@ module FacebookAds
   # pull request for this class.
 
   class VehicleOffer < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
 
     field :amount_currency, 'string'
     field :amount_percentage, 'double'
@@ -44,6 +53,7 @@ module FacebookAds
     field :end_date, 'string'
     field :end_time, 'int'
     field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
     field :images, { list: 'string' }
     field :make, 'string'
     field :model, 'string'
@@ -64,5 +74,13 @@ module FacebookAds
     has_no_post
     has_no_delete
 
+    has_edge :augmented_realities_metadata do |edge|
+      edge.get
+    end
+
+    has_edge :videos_metadata do |edge|
+      edge.get
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/whats_app_business_account.rb

@@ -31,6 +31,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_PHONE",
       "MANAGE_TEMPLATES",
+      "MESSAGING",
       "VIEW_COST",
     ]
 

data/lib/facebook_ads/ad_objects/{friend_list.rb → whats_app_business_profile.rb}

@@ -25,13 +25,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 FriendList < AdObject
+  class WhatsAppBusinessProfile < AdObject
 
     field :id, 'string'
-    field :list_type, 'string'
-    field :name, 'string'
-    field :owner, 'string'
-    has_no_post
+    field :name_verification, 'object'
+    field :whatsapp_business_api_data, 'object'
     has_no_delete
 
   end

data/lib/facebook_ads/edge.rb

@@ -53,6 +53,7 @@ module FacebookAds
     def reload!
       @collection = Array.new
       self.has_next_page = true
+      self.next_page_cursor = nil
     end
 
     private
@@ -95,7 +96,7 @@ module FacebookAds
       node.post_edge(name, graph_params.merge(params)) do |response|
         # TODO params check
         # TODO Add new object to collection?
-        
+
         field_type = self.class.return_types[:post]
 
         obj = field_type.deserialize(response, node.session)

data/lib/facebook_ads/version.rb

@@ -19,6 +19,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '0.9.0.0'
-  API_VERSION = '9.0'
+  VERSION = '0.10.0.1'
+  API_VERSION = '10.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 0.9.0.0
+  version: 0.10.0.1
 platform: ruby
 authors:
 - Facebook
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-11-13 00:00:00.000000000 Z
+date: 2021-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -142,14 +142,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: 5.14.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: 5.14.2
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -266,7 +266,6 @@ files:
 - lib/facebook_ads/ad_objects/ad_account_ad_rules_history.rb
 - lib/facebook_ads/ad_objects/ad_account_ad_volume.rb
 - lib/facebook_ads/ad_objects/ad_account_content_filter_levels_inheritance.rb
-- lib/facebook_ads/ad_objects/ad_account_creation_request.rb
 - lib/facebook_ads/ad_objects/ad_account_default_destination.rb
 - lib/facebook_ads/ad_objects/ad_account_default_objective.rb
 - lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb
@@ -275,7 +274,6 @@ files:
 - lib/facebook_ads/ad_objects/ad_account_promotable_objects.rb
 - lib/facebook_ads/ad_objects/ad_account_reach_estimate.rb
 - lib/facebook_ads/ad_objects/ad_account_recommended_camapaign_budget.rb
-- lib/facebook_ads/ad_objects/ad_account_roas.rb
 - lib/facebook_ads/ad_objects/ad_account_subscribed_apps.rb
 - lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb
 - lib/facebook_ads/ad_objects/ad_account_tracking_data.rb
@@ -320,6 +318,7 @@ files:
 - lib/facebook_ads/ad_objects/ad_creative_link_data_sponsorship_info_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_link_data_template_video_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb
+- lib/facebook_ads/ad_objects/ad_creative_omnichannel_link_spec.rb
 - lib/facebook_ads/ad_objects/ad_creative_photo_data.rb
 - lib/facebook_ads/ad_objects/ad_creative_photo_data_media_elements.rb
 - lib/facebook_ads/ad_objects/ad_creative_place_data.rb
@@ -419,6 +418,7 @@ files:
 - lib/facebook_ads/ad_objects/catalog_based_targeting.rb
 - lib/facebook_ads/ad_objects/catalog_item_app_links.rb
 - lib/facebook_ads/ad_objects/catalog_item_appeal_status.rb
+- lib/facebook_ads/ad_objects/catalog_item_channels_to_integrity_status.rb
 - lib/facebook_ads/ad_objects/catalog_sub_vertical_list.rb
 - lib/facebook_ads/ad_objects/check_batch_request_status.rb
 - lib/facebook_ads/ad_objects/child_event.rb
@@ -433,6 +433,7 @@ files:
 - lib/facebook_ads/ad_objects/commerce_settings.rb
 - lib/facebook_ads/ad_objects/connections_targeting.rb
 - lib/facebook_ads/ad_objects/content_delivery_report.rb
+- lib/facebook_ads/ad_objects/contextual_bundling_spec.rb
 - lib/facebook_ads/ad_objects/conversion_action_query.rb
 - lib/facebook_ads/ad_objects/copyright_reference_container.rb
 - lib/facebook_ads/ad_objects/cover_photo.rb
@@ -458,6 +459,7 @@ files:
 - lib/facebook_ads/ad_objects/day_part.rb
 - lib/facebook_ads/ad_objects/delivery_check.rb
 - lib/facebook_ads/ad_objects/delivery_check_extra_info.rb
+- lib/facebook_ads/ad_objects/delivery_window.rb
 - lib/facebook_ads/ad_objects/destination.rb
 - lib/facebook_ads/ad_objects/destination_catalog_settings.rb
 - lib/facebook_ads/ad_objects/domain.rb
@@ -468,7 +470,6 @@ files:
 - lib/facebook_ads/ad_objects/entity_at_text_range.rb
 - lib/facebook_ads/ad_objects/event.rb
 - lib/facebook_ads/ad_objects/event_source_group.rb
-- lib/facebook_ads/ad_objects/event_tour.rb
 - lib/facebook_ads/ad_objects/experience.rb
 - lib/facebook_ads/ad_objects/extended_credit.rb
 - lib/facebook_ads/ad_objects/extended_credit_allocation_config.rb
@@ -477,7 +478,6 @@ files:
 - lib/facebook_ads/ad_objects/fame_export_config.rb
 - lib/facebook_ads/ad_objects/flexible_targeting.rb
 - lib/facebook_ads/ad_objects/flight.rb
-- lib/facebook_ads/ad_objects/friend_list.rb
 - lib/facebook_ads/ad_objects/funding_source_details.rb
 - lib/facebook_ads/ad_objects/funding_source_details_coupon.rb
 - lib/facebook_ads/ad_objects/group.rb
@@ -489,13 +489,14 @@ files:
 - lib/facebook_ads/ad_objects/ig_comment.rb
 - lib/facebook_ads/ad_objects/ig_media.rb
 - lib/facebook_ads/ad_objects/ig_user.rb
+- lib/facebook_ads/ad_objects/image_copyright.rb
 - lib/facebook_ads/ad_objects/insights_result.rb
 - lib/facebook_ads/ad_objects/instagram_insights_result.rb
 - lib/facebook_ads/ad_objects/instagram_insights_value.rb
 - lib/facebook_ads/ad_objects/instagram_user.rb
 - lib/facebook_ads/ad_objects/instant_article.rb
 - lib/facebook_ads/ad_objects/instant_article_insights_query_result.rb
-- lib/facebook_ads/ad_objects/invoice_campaign.rb
+- lib/facebook_ads/ad_objects/invoice_campaign_new.rb
 - lib/facebook_ads/ad_objects/ios_app_link.rb
 - lib/facebook_ads/ad_objects/key_value.rb
 - lib/facebook_ads/ad_objects/lead.rb
@@ -530,8 +531,8 @@ files:
 - lib/facebook_ads/ad_objects/native_offer_view.rb
 - lib/facebook_ads/ad_objects/null_node.rb
 - lib/facebook_ads/ad_objects/offline_conversion_data_set.rb
-- lib/facebook_ads/ad_objects/offline_terms_of_service.rb
 - lib/facebook_ads/ad_objects/offsite_pixel.rb
+- lib/facebook_ads/ad_objects/omega_customer_trx.rb
 - lib/facebook_ads/ad_objects/open_graph_context.rb
 - lib/facebook_ads/ad_objects/oracle_transaction.rb
 - lib/facebook_ads/ad_objects/outcome_prediction_point.rb
@@ -540,6 +541,7 @@ 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
@@ -552,6 +554,7 @@ files:
 - lib/facebook_ads/ad_objects/page_upcoming_change.rb
 - lib/facebook_ads/ad_objects/page_user_message_thread_label.rb
 - lib/facebook_ads/ad_objects/partner_study.rb
+- lib/facebook_ads/ad_objects/payment_engine_payment.rb
 - lib/facebook_ads/ad_objects/payment_pricepoints.rb
 - lib/facebook_ads/ad_objects/payment_subscription.rb
 - lib/facebook_ads/ad_objects/permission.rb
@@ -563,6 +566,7 @@ files:
 - lib/facebook_ads/ad_objects/playable_content.rb
 - lib/facebook_ads/ad_objects/post.rb
 - lib/facebook_ads/ad_objects/privacy.rb
+- lib/facebook_ads/ad_objects/private_lift_study_instance.rb
 - lib/facebook_ads/ad_objects/product_catalog.rb
 - lib/facebook_ads/ad_objects/product_catalog_category.rb
 - lib/facebook_ads/ad_objects/product_catalog_hotel_rooms_batch.rb
@@ -583,6 +587,7 @@ files:
 - lib/facebook_ads/ad_objects/product_feed_upload_error_sample.rb
 - lib/facebook_ads/ad_objects/product_group.rb
 - lib/facebook_ads/ad_objects/product_item.rb
+- lib/facebook_ads/ad_objects/product_item_ar_data.rb
 - lib/facebook_ads/ad_objects/product_item_commerce_insights.rb
 - lib/facebook_ads/ad_objects/product_set.rb
 - lib/facebook_ads/ad_objects/product_set_metadata.rb
@@ -600,7 +605,6 @@ files:
 - lib/facebook_ads/ad_objects/reach_frequency_estimates_placement_breakdown.rb
 - lib/facebook_ads/ad_objects/reach_frequency_prediction.rb
 - lib/facebook_ads/ad_objects/reach_frequency_spec.rb
-- lib/facebook_ads/ad_objects/read_only_analytics_user_property_config.rb
 - lib/facebook_ads/ad_objects/recommendation.rb
 - lib/facebook_ads/ad_objects/referral.rb
 - lib/facebook_ads/ad_objects/rev_share_policy.rb
@@ -609,6 +613,7 @@ files:
 - lib/facebook_ads/ad_objects/saved_audience.rb
 - lib/facebook_ads/ad_objects/saved_message_response.rb
 - lib/facebook_ads/ad_objects/security_settings.rb
+- lib/facebook_ads/ad_objects/server_side/action_source.rb
 - lib/facebook_ads/ad_objects/server_side/batch_processor.rb
 - lib/facebook_ads/ad_objects/server_side/content.rb
 - lib/facebook_ads/ad_objects/server_side/custom_data.rb
@@ -656,9 +661,7 @@ files:
 - lib/facebook_ads/ad_objects/user_id_for_page.rb
 - lib/facebook_ads/ad_objects/user_lead_gen_disclaimer_response.rb
 - lib/facebook_ads/ad_objects/user_lead_gen_field_data.rb
-- lib/facebook_ads/ad_objects/user_payment_methods_info.rb
 - lib/facebook_ads/ad_objects/user_payment_mobile_pricepoints.rb
-- lib/facebook_ads/ad_objects/user_payment_modules_options.rb
 - lib/facebook_ads/ad_objects/value_based_eligible_source.rb
 - lib/facebook_ads/ad_objects/vehicle.rb
 - lib/facebook_ads/ad_objects/vehicle_offer.rb
@@ -674,6 +677,7 @@ files:
 - lib/facebook_ads/ad_objects/voip_info.rb
 - lib/facebook_ads/ad_objects/web_app_link.rb
 - lib/facebook_ads/ad_objects/whats_app_business_account.rb
+- lib/facebook_ads/ad_objects/whats_app_business_profile.rb
 - lib/facebook_ads/ad_objects/windows_app_link.rb
 - lib/facebook_ads/ad_objects/windows_phone_app_link.rb
 - lib/facebook_ads/ad_objects/work_user_frontline.rb
@@ -720,23 +724,23 @@ homepage: https://github.com/facebook/facebook-ruby-business-sdk
 licenses:
 - Nonstandard
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '2.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Facebook Business API SDK for Ruby (Official)
 test_files: []