facebookbusiness 0.7.0.3 → 0.10.0.0

data/lib/facebook_ads/ad_objects/adgroup_activity.rb

@@ -113,6 +113,8 @@ module FacebookAds
     field :stop_time_old, 'datetime'
     field :target_spec_id_new, 'string'
     field :target_spec_id_old, 'string'
+    field :targets_spec_new, 'object'
+    field :targets_spec_old, 'object'
     field :tracking_pixel_ids_new, { list: 'string' }
     field :tracking_pixel_ids_old, { list: 'string' }
     field :tracking_specs_new, { list: 'object' }

data/lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb

@@ -44,6 +44,7 @@ module FacebookAds
     field :facebook_pages_live_shopping, 'hash'
     field :instagram, 'hash'
     field :instagram_shop, 'hash'
+    field :job_search, 'hash'
     field :lead_gen_honeypot, 'hash'
     field :marketplace, 'hash'
     field :marketplace_home_rentals, 'hash'

data/lib/facebook_ads/ad_objects/adoptable_pet.rb

@@ -35,17 +35,25 @@ module FacebookAds
     field :applinks, 'CatalogItemAppLinks'
     field :availability, 'string'
     field :breed, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
+    field :coat_length, 'string'
+    field :color, 'string'
     field :currency, 'string'
     field :description, 'string'
+    field :features, { list: 'string' }
     field :gender, 'string'
     field :id, 'string'
     field :images, { list: 'string' }
     field :name, 'string'
     field :price, 'string'
     field :sanitized_images, { list: 'string' }
+    field :secondary_color, 'string'
+    field :shelter_email, 'string'
     field :shelter_name, 'string'
     field :shelter_page_id, 'Page'
+    field :shelter_phone, 'string'
     field :size, 'string'
+    field :tertiary_color, 'string'
     field :url, 'string'
     has_no_post
     has_no_delete

data/lib/facebook_ads/ad_objects/ads_action_stats.rb

@@ -33,10 +33,12 @@ module FacebookAds
     field :_28d_view, 'string'
     field :_7d_click, 'string'
     field :_7d_view, 'string'
+    field :action_brand, 'string'
     field :action_canvas_component_id, 'string'
     field :action_canvas_component_name, 'string'
     field :action_carousel_card_id, 'string'
     field :action_carousel_card_name, 'string'
+    field :action_category, 'string'
     field :action_converted_product_id, 'string'
     field :action_destination, 'string'
     field :action_device, 'string'

data/lib/facebook_ads/ad_objects/ads_insights.rb

@@ -53,6 +53,7 @@ module FacebookAds
     ACTION_REPORT_TIME = [
       "conversion",
       "impression",
+      "mixed",
     ]
 
     BREAKDOWNS = [
@@ -92,7 +93,7 @@ module FacebookAds
       "last_week_mon_sun",
       "last_week_sun_sat",
       "last_year",
-      "lifetime",
+      "maximum",
       "this_month",
       "this_quarter",
       "this_week_mon_today",
@@ -145,6 +146,7 @@ module FacebookAds
     field :adset_name, 'string'
     field :adset_start, 'string'
     field :age_targeting, 'string'
+    field :attribution_setting, 'string'
     field :auction_bid, 'string'
     field :auction_competitiveness, 'string'
     field :auction_max_competitor_bid, 'string'

data/lib/facebook_ads/ad_objects/ads_pixel.rb

@@ -32,8 +32,11 @@ module FacebookAds
     ]
 
     AUTOMATIC_MATCHING_FIELDS = [
+      "country",
       "ct",
+      "db",
       "em",
+      "external_id",
       "fn",
       "ge",
       "ln",
@@ -90,6 +93,7 @@ module FacebookAds
     has_edge :da_checks do |edge|
       edge.get 'DaCheck' do |api|
         api.has_param :checks, { list: 'string' }
+        api.has_param :connection_method, { enum: -> { DaCheck::CONNECTION_METHOD }}
       end
     end
 
@@ -106,6 +110,10 @@ module FacebookAds
       end
     end
 
+    has_edge :shadowtraffichelper do |edge|
+      edge.post
+    end
+
     has_edge :shared_accounts do |edge|
       edge.delete do |api|
         api.has_param :account_id, 'string'

data/lib/facebook_ads/ad_objects/album.rb

@@ -152,15 +152,5 @@ module FacebookAds
       end
     end
 
-    has_edge :reactions do |edge|
-      edge.get 'Profile' do |api|
-        api.has_param :type, { enum: -> { Profile::TYPE }}
-      end
-    end
-
-    has_edge :sharedposts do |edge|
-      edge.get 'Post'
-    end
-
   end
 end

data/lib/facebook_ads/ad_objects/application.rb

@@ -36,6 +36,7 @@ module FacebookAds
       "IPHONE",
       "MOBILE_WEB",
       "OCULUS",
+      "SAMSUNG",
       "SUPPLEMENTARY_IMAGES",
       "WEB",
       "WINDOWS",
@@ -100,6 +101,7 @@ module FacebookAds
     field :android_key_hash, { list: 'string' }
     field :android_sdk_error_categories, { list: 'object' }
     field :app_domains, { list: 'string' }
+    field :app_events_config, 'object'
     field :app_events_feature_bitmask, 'int'
     field :app_events_session_timeout, 'int'
     field :app_install_tracked, 'bool'
@@ -227,6 +229,7 @@ module FacebookAds
         api.has_param :bundle_id, 'string'
         api.has_param :bundle_short_version, 'string'
         api.has_param :bundle_version, 'string'
+        api.has_param :click_id, 'string'
         api.has_param :consider_views, 'bool'
         api.has_param :custom_events, { list: 'object' }
         api.has_param :custom_events_file, 'file'
@@ -239,6 +242,7 @@ module FacebookAds
         api.has_param :include_dwell_data, 'bool'
         api.has_param :include_video_data, 'bool'
         api.has_param :install_referrer, 'string'
+        api.has_param :install_timestamp, 'int'
         api.has_param :installer_package, 'string'
         api.has_param :limited_data_use, 'bool'
         api.has_param :migration_bundle, 'string'
@@ -288,6 +292,18 @@ module FacebookAds
       edge.get 'Business'
     end
 
+    has_edge :aggregate_revenue do |edge|
+      edge.post do |api|
+        api.has_param :ecpms, { list: 'string' }
+        api.has_param :query_ids, { list: 'string' }
+        api.has_param :request_id, 'string'
+      end
+    end
+
+    has_edge :android_dialog_configs do |edge|
+      edge.get
+    end
+
     has_edge :app_event_types do |edge|
       edge.get
     end
@@ -389,6 +405,7 @@ module FacebookAds
     has_edge :da_checks do |edge|
       edge.get 'DaCheck' do |api|
         api.has_param :checks, { list: 'string' }
+        api.has_param :connection_method, { enum: -> { DaCheck::CONNECTION_METHOD }}
       end
     end
 
@@ -478,6 +495,7 @@ module FacebookAds
       edge.get do |api|
         api.has_param :device_id, 'string'
         api.has_param :extinfo, 'object'
+        api.has_param :os_version, 'string'
         api.has_param :platform, { enum: %w{ANDROID IOS }}
         api.has_param :sdk_version, 'string'
       end
@@ -490,10 +508,6 @@ module FacebookAds
       end
     end
 
-    has_edge :ozone_release do |edge|
-      edge.get
-    end
-
     has_edge :page_activities do |edge|
       edge.post 'Application' do |api|
         api.has_param :advertiser_tracking_enabled, 'bool'

data/lib/facebook_ads/ad_objects/atlas_campaign.rb

@@ -145,7 +145,7 @@ module FacebookAds
         api.has_param :dimensions, { list: { enum: %w{AD_ID AD_SET_ID CAMPAIGN_ID DEVICE_TYPE SOURCE_CHANNEL }} }
         api.has_param :granularity, { enum: %w{DAY HOUR MONTH WEEK_SUNDAY YEAR }}
         api.has_param :metric_scope, 'hash'
-        api.has_param :order_by, { list: 'string' }
+        api.has_param :order_by, { list: 'hash' }
       end
     end
 

data/lib/facebook_ads/ad_objects/automotive_model.rb

@@ -26,11 +26,37 @@ module FacebookAds
   # pull request for this class.
 
   class AutomotiveModel < AdObject
+    BODY_STYLE = [
+      "CONVERTIBLE",
+      "COUPE",
+      "CROSSOVER",
+      "ESTATE",
+      "GRANDTOURER",
+      "HATCHBACK",
+      "MINIBUS",
+      "MINIVAN",
+      "MPV",
+      "NONE",
+      "OTHER",
+      "PICKUP",
+      "ROADSTER",
+      "SALOON",
+      "SEDAN",
+      "SPORTSCAR",
+      "SUPERCAR",
+      "SUPERMINI",
+      "SUV",
+      "TRUCK",
+      "VAN",
+      "WAGON",
+    ]
+
 
     field :applinks, 'CatalogItemAppLinks'
     field :automotive_model_id, 'string'
     field :availability, 'string'
     field :body_style, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :currency, 'string'
     field :custom_label_0, 'string'
     field :description, 'string'

data/lib/facebook_ads/ad_objects/business.rb

@@ -60,6 +60,7 @@ module FacebookAds
     PERMITTED_TASKS = [
       "ADVERTISE",
       "ANALYZE",
+      "DRAFT",
       "MANAGE",
     ]
 
@@ -78,6 +79,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_JOBS",
       "MANAGE_LEADS",
+      "MESSAGING",
       "MODERATE",
       "MODERATE_COMMUNITY",
       "PAGES_MESSAGING",
@@ -117,11 +119,18 @@ module FacebookAds
     has_edge :access_token do |edge|
       edge.post 'Business' do |api|
         api.has_param :app_id, 'string'
+        api.has_param :fbe_external_business_id, 'string'
         api.has_param :scope, { list: 'Permission' }
         api.has_param :system_user_name, 'string'
       end
     end
 
+    has_edge :ad_accounts do |edge|
+      edge.delete do |api|
+        api.has_param :adaccount_id, 'string'
+      end
+    end
+
     has_edge :ad_studies do |edge|
       edge.get 'AdStudy'
       edge.post 'AdStudy' do |api|
@@ -207,6 +216,14 @@ module FacebookAds
       edge.get 'Business'
     end
 
+    has_edge :aggregate_revenue do |edge|
+      edge.post do |api|
+        api.has_param :ecpms, { list: 'string' }
+        api.has_param :query_ids, { list: 'string' }
+        api.has_param :request_id, 'string'
+      end
+    end
+
     has_edge :an_placements do |edge|
       edge.get 'AdPlacement'
     end
@@ -285,6 +302,10 @@ module FacebookAds
       edge.get 'ProductCatalog'
     end
 
+    has_edge :client_whatsapp_business_accounts do |edge|
+      edge.get 'WhatsAppBusinessAccount'
+    end
+
     has_edge :clients do |edge|
       edge.delete do |api|
         api.has_param :business, 'string'
@@ -292,6 +313,26 @@ module FacebookAds
       edge.get 'Business'
     end
 
+    has_edge :collaborative_ads_collaboration_requests do |edge|
+      edge.get 'CpasCollaborationRequest' do |api|
+        api.has_param :status, 'string'
+      end
+      edge.post 'CpasCollaborationRequest' do |api|
+        api.has_param :brands, { list: 'string' }
+        api.has_param :contact_email, 'string'
+        api.has_param :contact_first_name, 'string'
+        api.has_param :contact_last_name, 'string'
+        api.has_param :phone_number, 'string'
+        api.has_param :receiver_business, 'string'
+        api.has_param :requester_agency_or_brand, { enum: -> { CpasCollaborationRequest::REQUESTER_AGENCY_OR_BRAND }}
+        api.has_param :sender_client_business, 'string'
+      end
+    end
+
+    has_edge :collaborative_ads_suggested_partners do |edge|
+      edge.get 'CpasAdvertiserPartnershipRecommendation'
+    end
+
     has_edge :commerce_merchant_settings do |edge|
       edge.get 'CommerceMerchantSettings'
     end
@@ -307,6 +348,14 @@ module FacebookAds
       end
     end
 
+    has_edge :create_and_apply_publisher_block_list do |edge|
+      edge.post do |api|
+        api.has_param :is_auto_blocking_on, 'bool'
+        api.has_param :name, 'string'
+        api.has_param :publisher_urls, { list: 'string' }
+      end
+    end
+
     has_edge :customconversions do |edge|
       edge.post 'CustomConversion' do |api|
         api.has_param :advanced_rule, 'string'
@@ -333,6 +382,20 @@ module FacebookAds
       end
     end
 
+    has_edge :franchise_programs do |edge|
+      edge.post do |api|
+        api.has_param :business_asset_group, 'string'
+        api.has_param :creative_folder, 'string'
+        api.has_param :creative_spec_template_data, 'hash'
+        api.has_param :description, 'string'
+        api.has_param :end_date, 'datetime'
+        api.has_param :name, 'string'
+        api.has_param :program_approval_type, { enum: %w{APPROVAL PUBLIC }}
+        api.has_param :shared_custom_audience, 'string'
+        api.has_param :start_date, 'datetime'
+      end
+    end
+
     has_edge :initiated_audience_sharing_requests do |edge|
       edge.get 'BusinessAssetSharingAgreement' do |api|
         api.has_param :recipient_id, 'string'
@@ -354,11 +417,16 @@ module FacebookAds
       edge.get 'InstagramUser'
     end
 
+    has_edge :instagram_business_accounts do |edge|
+      edge.get 'IgUser'
+    end
+
     has_edge :managed_businesses do |edge|
       edge.delete do |api|
         api.has_param :existing_client_business_id, 'string'
       end
       edge.post 'Business' do |api|
+        api.has_param :child_business_external_id, 'string'
         api.has_param :existing_client_business_id, 'string'
         api.has_param :name, 'string'
         api.has_param :sales_rep_email, 'string'
@@ -407,9 +475,11 @@ module FacebookAds
         api.has_param :client_id, 'string'
       end
       edge.get 'Business' do |api|
+        api.has_param :child_business_external_id, 'string'
         api.has_param :client_user_id, 'int'
       end
       edge.post 'Business' do |api|
+        api.has_param :child_business_external_id, 'string'
         api.has_param :name, 'string'
         api.has_param :page_permitted_tasks, { list: { enum: -> { Business::PAGE_PERMITTED_TASKS }} }
         api.has_param :sales_rep_email, 'string'
@@ -441,17 +511,22 @@ module FacebookAds
     has_edge :owned_product_catalogs do |edge|
       edge.get 'ProductCatalog'
       edge.post 'ProductCatalog' do |api|
-        api.has_param :commerce_merchant_settings, 'object'
+        api.has_param :catalog_segment_filter, 'object'
+        api.has_param :catalog_segment_product_set_id, 'string'
         api.has_param :da_display_settings, 'object'
         api.has_param :destination_catalog_settings, 'hash'
         api.has_param :flight_catalog_settings, 'hash'
         api.has_param :name, 'string'
-        api.has_param :onsite_commerce_merchant, 'object'
+        api.has_param :parent_catalog_id, 'string'
         api.has_param :store_catalog_settings, 'hash'
         api.has_param :vertical, { enum: -> { ProductCatalog::VERTICAL }}
       end
     end
 
+    has_edge :owned_whatsapp_business_accounts do |edge|
+      edge.get 'WhatsAppBusinessAccount'
+    end
+
     has_edge :pages do |edge|
       edge.delete do |api|
         api.has_param :page_id, 'int'

data/lib/facebook_ads/ad_objects/business_asset_group.rb

@@ -29,6 +29,7 @@ module FacebookAds
     ADACCOUNT_TASKS = [
       "ADVERTISE",
       "ANALYZE",
+      "DRAFT",
       "MANAGE",
     ]
 
@@ -47,6 +48,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_JOBS",
       "MANAGE_LEADS",
+      "MESSAGING",
       "MODERATE",
       "MODERATE_COMMUNITY",
       "PAGES_MESSAGING",

data/lib/facebook_ads/ad_objects/business_role_request.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",