facebookbusiness 0.7.0.3 → 0.8.0.4

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

@@ -58,6 +58,8 @@ module FacebookAds
 					normalized_input = normalize_city input
 				when 'currency'
 					return normalize_currency input
+				when 'delivery_category'
+					return normalize_delivery_category input
 				when 'em'
 					normalized_input = normalize_email input
 				when 'ge'
@@ -277,6 +279,17 @@ module FacebookAds
 				end
 				doby
 			end
+
+			# Normalizes the input delivery category and returns valid value (or throw exception if invalid).
+			def self.normalize_delivery_category(delivery_category)
+
+				unless FacebookAds::ServerSide::DeliveryCategory.include?(delivery_category)
+					raise ArgumentError.new("Invalid delivery_category passed: " + delivery_category + ". Please use one of the defined values #{FacebookAds::ServerSide::DeliveryCategory.to_a.join(',')}" )
+				end
+
+				delivery_category;
+			end
+
 		end
 	end
 end

data/lib/facebook_ads/ad_objects/system_user.rb

@@ -29,10 +29,14 @@ module FacebookAds
     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",
@@ -70,9 +74,5 @@ module FacebookAds
       edge.get 'ProductCatalog'
     end
 
-    has_edge :updated_by do |edge|
-      edge.get 'User'
-    end
-
   end
 end

data/lib/facebook_ads/ad_objects/targeting.rb

@@ -50,7 +50,7 @@ module FacebookAds
     field :catalog_based_targeting, 'CatalogBasedTargeting'
     field :cities, { list: 'IdName' }
     field :college_years, { list: 'int' }
-    field :connections, { list: 'IdName' }
+    field :connections, { list: 'ConnectionsTargeting' }
     field :contextual_targeting_categories, { list: 'IdName' }
     field :countries, { list: 'string' }
     field :country, { list: 'string' }
@@ -72,7 +72,7 @@ module FacebookAds
     field :ethnic_affinity, { list: 'IdName' }
     field :exclude_reached_since, { list: 'string' }
     field :excluded_brand_safety_content_types, { list: 'string' }
-    field :excluded_connections, { list: 'IdName' }
+    field :excluded_connections, { list: 'ConnectionsTargeting' }
     field :excluded_custom_audiences, { list: 'RawCustomAudience' }
     field :excluded_dynamic_audience_ids, { list: 'string' }
     field :excluded_engagement_specs, { list: 'TargetingDynamicRule' }
@@ -87,7 +87,7 @@ module FacebookAds
     field :family_statuses, { list: 'IdName' }
     field :fb_deal_id, 'string'
     field :flexible_spec, { list: 'FlexibleTargeting' }
-    field :friends_of_connections, { list: 'IdName' }
+    field :friends_of_connections, { list: 'ConnectionsTargeting' }
     field :genders, { list: 'int' }
     field :generation, { list: 'IdName' }
     field :geo_locations, 'TargetingGeoLocation'

data/lib/facebook_ads/ad_objects/third_party_measurement_report_dataset.rb

@@ -32,7 +32,6 @@ module FacebookAds
     field :partner, 'Business'
     field :product, 'string'
     field :schema, { list: 'object' }
-    has_no_post
     has_no_delete
 
   end

data/lib/facebook_ads/ad_objects/unified_thread.rb

@@ -32,6 +32,7 @@ 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

@@ -54,7 +54,6 @@ module FacebookAds
     field :age_range, 'AgeRange'
     field :auth_method, 'string'
     field :birthday, 'string'
-    field :can_review_measurement_request, 'bool'
     field :cover, 'UserCoverPhoto'
     field :currency, 'Currency'
     field :devices, { list: 'UserDevice' }
@@ -70,9 +69,7 @@ module FacebookAds
     field :install_type, 'string'
     field :installed, 'bool'
     field :interested_in, { list: 'string' }
-    field :is_famedeeplinkinguser, 'bool'
     field :is_guest_user, 'bool'
-    field :is_shared_login, 'bool'
     field :is_verified, 'bool'
     field :languages, { list: 'Experience' }
     field :last_name, 'string'
@@ -82,6 +79,7 @@ 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'
@@ -89,23 +87,23 @@ module FacebookAds
     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'
-    field :security_settings, 'SecuritySettings'
     field :shared_login_upgrade_required_by, 'datetime'
     field :short_name, 'string'
     field :significant_other, 'User'
     field :sports, { list: 'Experience' }
     field :supports_donate_button_in_live_video, 'bool'
-    field :test_group, 'int'
     field :third_party_id, 'string'
     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 :viewer_can_send_gift, 'bool'
     field :website, 'string'
     field :work, { list: 'object' }
 
@@ -211,6 +209,7 @@ module FacebookAds
       end
       edge.get 'Business'
       edge.post 'Business' do |api|
+        api.has_param :child_business_external_id, 'string'
         api.has_param :email, 'string'
         api.has_param :name, 'string'
         api.has_param :primary_page, 'string'
@@ -243,7 +242,15 @@ module FacebookAds
     end
 
     has_edge :feed do |edge|
-      edge.post do |api|
+      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
+      edge.post 'Post' do |api|
         api.has_param :actions, 'object'
         api.has_param :adaptive_type, 'string'
         api.has_param :album_id, 'string'
@@ -257,10 +264,10 @@ module FacebookAds
         api.has_param :attached_media, { list: 'object' }
         api.has_param :audience_exp, 'bool'
         api.has_param :backdated_time, 'datetime'
-        api.has_param :backdated_time_granularity, { enum: %w{day hour min month none year }}
+        api.has_param :backdated_time_granularity, { enum: -> { Post::BACKDATED_TIME_GRANULARITY }}
         api.has_param :call_to_action, 'object'
         api.has_param :caption, 'string'
-        api.has_param :checkin_entry_point, { enum: %w{BRANDING_CHECKIN BRANDING_OTHER BRANDING_PHOTO BRANDING_STATUS }}
+        api.has_param :checkin_entry_point, { enum: -> { Post::CHECKIN_ENTRY_POINT }}
         api.has_param :child_attachments, { list: 'object' }
         api.has_param :client_mutation_id, 'string'
         api.has_param :composer_entry_picker, 'string'
@@ -280,7 +287,7 @@ module FacebookAds
         api.has_param :expanded_height, 'int'
         api.has_param :expanded_width, 'int'
         api.has_param :feed_targeting, 'object'
-        api.has_param :formatting, { enum: %w{MARKDOWN PLAINTEXT }}
+        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'
@@ -317,11 +324,11 @@ module FacebookAds
         api.has_param :page_recommendation, 'string'
         api.has_param :picture, 'string'
         api.has_param :place, 'object'
-        api.has_param :place_attachment_setting, { enum: %w{1 2 }}
+        api.has_param :place_attachment_setting, { enum: -> { Post::PLACE_ATTACHMENT_SETTING }}
         api.has_param :place_list, 'string'
         api.has_param :place_list_data, { list: 'string' }
-        api.has_param :post_surfaces_blacklist, { list: { enum: %w{1 2 3 4 5 }} }
-        api.has_param :posting_to_redspace, { enum: %w{disabled enabled }}
+        api.has_param :post_surfaces_blacklist, { list: { enum: -> { Post::POST_SURFACES_BLACKLIST }} }
+        api.has_param :posting_to_redspace, { enum: -> { Post::POSTING_TO_REDSPACE }}
         api.has_param :privacy, 'string'
         api.has_param :prompt_id, 'string'
         api.has_param :prompt_tracking_string, 'string'
@@ -341,7 +348,7 @@ module FacebookAds
         api.has_param :sponsor_relationship, 'int'
         api.has_param :suggested_place_id, 'object'
         api.has_param :tags, { list: 'int' }
-        api.has_param :target_surface, { enum: %w{STORY TIMELINE }}
+        api.has_param :target_surface, { enum: -> { Post::TARGET_SURFACE }}
         api.has_param :targeting, 'object'
         api.has_param :text_format_metadata, 'string'
         api.has_param :text_format_preset_id, 'string'
@@ -351,7 +358,7 @@ module FacebookAds
         api.has_param :time_since_original_post, 'int'
         api.has_param :title, 'string'
         api.has_param :tracking_info, 'string'
-        api.has_param :unpublished_content_type, { enum: %w{ADS_POST DRAFT INLINE_CREATED PUBLISHED REVIEWABLE_BRANDED_CONTENT SCHEDULED SCHEDULED_RECURRING }}
+        api.has_param :unpublished_content_type, { enum: -> { Post::UNPUBLISHED_CONTENT_TYPE }}
         api.has_param :user_selected_tags, 'bool'
         api.has_param :video_start_time_ms, 'int'
         api.has_param :viewer_coordinates, 'object'
@@ -468,6 +475,7 @@ module FacebookAds
       edge.post 'LiveVideo' do |api|
         api.has_param :content_tags, { list: 'string' }
         api.has_param :description, 'string'
+        api.has_param :enable_backup_ingest, 'bool'
         api.has_param :encoding_settings, 'string'
         api.has_param :fisheye_video_cropped, 'bool'
         api.has_param :front_z_rotation, 'double'
@@ -479,7 +487,6 @@ module FacebookAds
         api.has_param :privacy, 'string'
         api.has_param :projection, { enum: -> { LiveVideo::PROJECTION }}
         api.has_param :published, 'bool'
-        api.has_param :save_vod, 'bool'
         api.has_param :schedule_custom_profile_image, 'file'
         api.has_param :spatial_audio_format, { enum: -> { LiveVideo::SPATIAL_AUDIO_FORMAT }}
         api.has_param :status, { enum: -> { LiveVideo::STATUS }}
@@ -490,11 +497,6 @@ module FacebookAds
       end
     end
 
-    has_edge :meeting_link do |edge|
-      edge.get 'WorkMeetingLink'
-      edge.post 'WorkMeetingLink'
-    end
-
     has_edge :music do |edge|
       edge.get 'Page' do |api|
         api.has_param :target_id, 'string'
@@ -514,6 +516,10 @@ module FacebookAds
       end
     end
 
+    has_edge :owned_product_catalogs do |edge|
+      edge.get 'ProductCatalog'
+    end
+
     has_edge :permissions do |edge|
       edge.delete do |api|
         api.has_param :permission, 'string'
@@ -610,10 +616,6 @@ module FacebookAds
       end
     end
 
-    has_edge :taggable_friends do |edge|
-      edge.get 'UserTaggableFriend'
-    end
-
     has_edge :videos do |edge|
       edge.get 'AdVideo' do |api|
         api.has_param :type, { enum: -> { AdVideo::TYPE }}

data/lib/facebook_ads/ad_objects/vehicle.rb

@@ -29,6 +29,7 @@ module FacebookAds
     AVAILABILITY = [
       "AVAILABLE",
       "NOT_AVAILABLE",
+      "PENDING",
     ]
 
     BODY_STYLE = [
@@ -108,6 +109,7 @@ module FacebookAds
     field :applinks, 'CatalogItemAppLinks'
     field :availability, 'string'
     field :body_style, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :condition, 'string'
     field :currency, 'string'
     field :custom_label_0, 'string'

data/lib/facebook_ads/ad_objects/vehicle_offer.rb

@@ -35,6 +35,7 @@ module FacebookAds
     field :body_style, 'string'
     field :cashback_currency, 'string'
     field :cashback_price, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :currency, 'string'
     field :dma_codes, { list: 'string' }
     field :downpayment_currency, 'string'

data/lib/facebook_ads/ad_objects/whats_app_business_account.rb

@@ -26,6 +26,14 @@ module FacebookAds
   # pull request for this class.
 
   class WhatsAppBusinessAccount < AdObject
+    TASKS = [
+      "DEVELOP",
+      "MANAGE",
+      "MANAGE_PHONE",
+      "MANAGE_TEMPLATES",
+      "VIEW_COST",
+    ]
+
     CATEGORY = [
       "ACCOUNT_UPDATE",
       "ALERT_UPDATE",
@@ -47,12 +55,27 @@ module FacebookAds
     field :message_template_namespace, 'string'
     field :name, 'string'
     field :on_behalf_of_business_info, 'object'
+    field :owner_business_info, 'object'
+    field :primary_funding_id, 'string'
     field :purchase_order_number, 'string'
     field :status, 'string'
     field :timezone_id, 'string'
     has_no_post
     has_no_delete
 
+    has_edge :assigned_users do |edge|
+      edge.delete do |api|
+        api.has_param :user, 'int'
+      end
+      edge.get 'AssignedUser' do |api|
+        api.has_param :business, 'string'
+      end
+      edge.post 'WhatsAppBusinessAccount' do |api|
+        api.has_param :tasks, { list: { enum: -> { WhatsAppBusinessAccount::TASKS }} }
+        api.has_param :user, 'int'
+      end
+    end
+
     has_edge :message_templates do |edge|
       edge.delete do |api|
         api.has_param :name, 'string'
@@ -78,6 +101,8 @@ module FacebookAds
     end
 
     has_edge :subscribed_apps do |edge|
+      edge.delete
+      edge.get
       edge.post 'WhatsAppBusinessAccount'
     end
 

data/lib/facebook_ads/errors.rb

@@ -26,7 +26,7 @@ module FacebookAds
     ERROR_ATTRS = [
       :headers, :fb_message, :type, :code,
       :error_subcode, :is_transient, :error_user_title,
-      :error_user_msg, :fbtrace_id,
+      :error_user_msg, :error_data, :fbtrace_id,
     ]
 
     attr_accessor *ERROR_ATTRS

data/lib/facebook_ads/session.rb

@@ -39,7 +39,7 @@ module FacebookAds
       case method
         when :get, :post, :delete
           api_conn.send(method, path.gsub(/^\//,''), params) do |req|
-            req.headers[:user_agent] = "fbbizsdk-ruby-v#{API_VERSION}".freeze
+            req.headers[:user_agent] = "fbbizsdk-ruby-v#{VERSION}".freeze
             req.params[:access_token] = access_token if access_token
             req.params[:appsecret_proof] = appsecret_proof if app_secret
           end

data/lib/facebook_ads/version.rb

@@ -19,6 +19,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '0.7.0.3'
-  API_VERSION = '7.0'
+  VERSION = '0.8.0.4'
+  API_VERSION = '8.0'
 end

metadata

@@ -1,29 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 0.7.0.3
+  version: 0.8.0.4
 platform: ruby
 authors:
 - Facebook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-02 00:00:00.000000000 Z
+date: 2020-11-10 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
@@ -170,14 +184,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -376,7 +390,6 @@ files:
 - lib/facebook_ads/ad_objects/async_request.rb
 - lib/facebook_ads/ad_objects/async_session.rb
 - lib/facebook_ads/ad_objects/atlas_campaign.rb
-- lib/facebook_ads/ad_objects/atlas_url.rb
 - lib/facebook_ads/ad_objects/attribution_spec.rb
 - lib/facebook_ads/ad_objects/audience_insights_study_spec.rb
 - lib/facebook_ads/ad_objects/audience_permission_for_actions.rb
@@ -406,6 +419,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_sub_vertical_list.rb
 - lib/facebook_ads/ad_objects/check_batch_request_status.rb
 - lib/facebook_ads/ad_objects/child_event.rb
 - lib/facebook_ads/ad_objects/collaborative_ads_partner_info_list_item.rb
@@ -417,10 +431,13 @@ files:
 - lib/facebook_ads/ad_objects/commerce_order_transaction_detail.rb
 - lib/facebook_ads/ad_objects/commerce_payout.rb
 - 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/conversion_action_query.rb
 - lib/facebook_ads/ad_objects/copyright_reference_container.rb
 - lib/facebook_ads/ad_objects/cover_photo.rb
+- lib/facebook_ads/ad_objects/cpas_advertiser_partnership_recommendation.rb
+- lib/facebook_ads/ad_objects/cpas_collaboration_request.rb
 - lib/facebook_ads/ad_objects/cpas_parent_catalog_settings.rb
 - lib/facebook_ads/ad_objects/creative_history.rb
 - lib/facebook_ads/ad_objects/credit_partition_action_options.rb
@@ -480,7 +497,6 @@ files:
 - lib/facebook_ads/ad_objects/instant_article_insights_query_result.rb
 - lib/facebook_ads/ad_objects/invoice_campaign.rb
 - lib/facebook_ads/ad_objects/ios_app_link.rb
-- lib/facebook_ads/ad_objects/iterative_split_test_config.rb
 - lib/facebook_ads/ad_objects/key_value.rb
 - lib/facebook_ads/ad_objects/lead.rb
 - lib/facebook_ads/ad_objects/lead_gen_appointment_booking_info.rb
@@ -520,7 +536,6 @@ files:
 - lib/facebook_ads/ad_objects/oracle_transaction.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_admin_note.rb
 - lib/facebook_ads/ad_objects/page_call_to_action.rb
 - lib/facebook_ads/ad_objects/page_category.rb
@@ -594,14 +609,19 @@ 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/batch_processor.rb
 - lib/facebook_ads/ad_objects/server_side/content.rb
 - lib/facebook_ads/ad_objects/server_side/custom_data.rb
+- lib/facebook_ads/ad_objects/server_side/delivery_category.rb
 - lib/facebook_ads/ad_objects/server_side/event.rb
 - lib/facebook_ads/ad_objects/server_side/event_request.rb
+- lib/facebook_ads/ad_objects/server_side/event_request_async.rb
 - lib/facebook_ads/ad_objects/server_side/event_response.rb
+- 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/user_data.rb
 - lib/facebook_ads/ad_objects/server_side/util.rb
-- lib/facebook_ads/ad_objects/split_test_config.rb
 - lib/facebook_ads/ad_objects/split_test_winner.rb
 - lib/facebook_ads/ad_objects/store_catalog_settings.rb
 - lib/facebook_ads/ad_objects/system_user.rb
@@ -639,7 +659,6 @@ files:
 - 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/user_taggable_friend.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
@@ -657,7 +676,6 @@ files:
 - lib/facebook_ads/ad_objects/whats_app_business_account.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_meeting_link.rb
 - lib/facebook_ads/ad_objects/work_user_frontline.rb
 - lib/facebook_ads/api_request.rb
 - lib/facebook_ads/api_response.rb