facebookbusiness 0.8.0.0 → 0.9.0.1

data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb

@@ -26,17 +26,14 @@ module FacebookAds
   # pull request for this class.
 
   class CommerceMerchantSettings < AdObject
-    MERCHANT_STATUS = [
-      "ENABLED",
-      "EXTERNALLY_DISABLED",
-    ]
-
 
     field :braintree_merchant_id, 'string'
     field :checkout_message, 'string'
     field :contact_email, 'string'
+    field :cta, 'string'
     field :disable_checkout_urls, 'bool'
     field :display_name, 'string'
+    field :external_merchant_id, 'string'
     field :facebook_channel, 'object'
     field :has_discount_code, 'bool'
     field :id, 'string'
@@ -54,22 +51,9 @@ module FacebookAds
     field :terms, 'string'
     field :terms_url_by_locale, 'hash'
     field :whatsapp_channel, 'object'
+    has_no_post
     has_no_delete
 
-    has_edge :facebook_channel do |edge|
-      edge.post 'CommerceMerchantSettings' do |api|
-        api.has_param :pages, { list: 'string' }
-      end
-    end
-
-    has_edge :instagram_channel do |edge|
-      edge.delete
-      edge.post 'CommerceMerchantSettings' do |api|
-        api.has_param :instagram_business_accounts, { list: 'string' }
-        api.has_param :instagram_users, { list: 'string' }
-      end
-    end
-
     has_edge :order_management_apps do |edge|
       edge.get 'Application'
       edge.post 'CommerceMerchantSettings'
@@ -92,6 +76,19 @@ module FacebookAds
       edge.get 'CommerceMerchantSettingsSetupStatus'
     end
 
+    has_edge :shipping_profiles do |edge|
+      edge.get do |api|
+        api.has_param :reference_id, 'string'
+      end
+      edge.post do |api|
+        api.has_param :handling_time, 'hash'
+        api.has_param :is_default_shipping_profile, 'bool'
+        api.has_param :name, 'string'
+        api.has_param :reference_id, 'string'
+        api.has_param :shipping_destinations, { list: 'hash' }
+      end
+    end
+
     has_edge :tax_settings do |edge|
       edge.get
     end

data/lib/facebook_ads/ad_objects/commerce_merchant_settings_setup_status.rb

@@ -31,6 +31,7 @@ module FacebookAds
     field :marketplace_approval_status, 'string'
     field :marketplace_approval_status_details, 'object'
     field :payment_setup, 'string'
+    field :review_status, 'object'
     field :shop_setup, 'string'
     has_no_id
     has_no_get

data/lib/facebook_ads/ad_objects/commerce_order.rb

@@ -62,6 +62,7 @@ module FacebookAds
     field :estimated_payment_details, 'object'
     field :id, 'string'
     field :is_group_buy, 'bool'
+    field :is_test_order, 'bool'
     field :last_updated, 'string'
     field :merchant_order_id, 'string'
     field :order_status, 'object'
@@ -75,6 +76,7 @@ module FacebookAds
       edge.post 'CommerceOrder' do |api|
         api.has_param :idempotency_key, 'string'
         api.has_param :merchant_order_reference, 'string'
+        api.has_param :return_error_response, 'bool'
       end
     end
 
@@ -96,6 +98,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :promotion_details do |edge|
+      edge.get
+    end
+
     has_edge :promotions do |edge|
       edge.get
     end

data/lib/facebook_ads/ad_objects/{work_meeting_link.rb → connections_targeting.rb}

@@ -25,10 +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 WorkMeetingLink < AdObject
+  class ConnectionsTargeting < AdObject
 
     field :id, 'string'
-    field :owner, 'User'
+    field :name, 'string'
+    has_no_get
     has_no_post
     has_no_delete
 

data/lib/facebook_ads/ad_objects/cpas_advertiser_partnership_recommendation.rb

@@ -0,0 +1,43 @@
+# 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.
+
+# 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 CpasAdvertiserPartnershipRecommendation < AdObject
+
+    field :advertiser_business_id, 'string'
+    field :brand_business_id, 'string'
+    field :brands, { list: 'string' }
+    field :countries, { list: 'string' }
+    field :id, 'string'
+    field :merchant_business_id, 'string'
+    field :merchant_categories, { list: 'string' }
+    field :status, 'string'
+    field :status_reason, 'string'
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/cpas_collaboration_request.rb

@@ -0,0 +1,50 @@
+# 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.
+
+# 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 CpasCollaborationRequest < AdObject
+    REQUESTER_AGENCY_OR_BRAND = [
+      "AGENCY",
+      "BRAND",
+      "MERCHANT",
+    ]
+
+
+    field :brands, { list: 'string' }
+    field :contact_email, 'string'
+    field :contact_first_name, 'string'
+    field :contact_last_name, 'string'
+    field :id, 'string'
+    field :phone_number, 'string'
+    field :receiver_business, 'Business'
+    field :requester_agency_or_brand, 'string'
+    field :sender_client_business, 'Business'
+    field :status, 'string'
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb

@@ -69,6 +69,7 @@ module FacebookAds
       "PLATFORM",
       "PLATFORM_USERS",
       "SEED_LIST",
+      "SIGNAL_SOURCE",
       "SMART_AUDIENCE",
       "STORE_VISIT_EVENTS",
       "S_EXPR",

data/lib/facebook_ads/ad_objects/da_check.rb

@@ -26,6 +26,13 @@ module FacebookAds
   # pull request for this class.
 
   class DaCheck < AdObject
+    CONNECTION_METHOD = [
+      "ALL",
+      "APP",
+      "BROWSER",
+      "SERVER",
+    ]
+
 
     field :action_uri, 'string'
     field :description, 'string'

data/lib/facebook_ads/ad_objects/destination.rb

@@ -29,6 +29,7 @@ module FacebookAds
 
     field :address, 'string'
     field :applinks, 'CatalogItemAppLinks'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :currency, 'string'
     field :description, 'string'
     field :destination_id, 'string'

data/lib/facebook_ads/ad_objects/event.rb

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

data/lib/facebook_ads/ad_objects/extended_credit.rb

@@ -34,7 +34,6 @@ module FacebookAds
     field :id, 'string'
     field :is_access_revoked, 'bool'
     field :is_automated_experience, 'bool'
-    field :last_payment_time, 'datetime'
     field :legal_entity_name, 'string'
     field :liable_biz_name, 'string'
     field :max_balance, 'CurrencyAmount'
@@ -68,5 +67,12 @@ module FacebookAds
       end
     end
 
+    has_edge :whatsapp_credit_sharing_and_attach do |edge|
+      edge.post do |api|
+        api.has_param :waba_currency, 'string'
+        api.has_param :waba_id, 'string'
+      end
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/flight.rb

@@ -28,6 +28,7 @@ module FacebookAds
   class Flight < AdObject
 
     field :applinks, 'CatalogItemAppLinks'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :currency, 'string'
     field :description, 'string'
     field :destination_airport, 'string'

data/lib/facebook_ads/ad_objects/group.rb

@@ -70,9 +70,11 @@ module FacebookAds
       "SCHOOL_CLASS",
       "SORORITY",
       "SPORTS",
+      "STREAMER",
       "STUDY_GROUP",
       "SUPPORT",
       "TEAMMATES",
+      "THEME",
       "TRAVEL_PLANNING",
       "WORK_ANNOUNCEMENT",
       "WORK_DEMO_GROUP",
@@ -80,6 +82,7 @@ module FacebookAds
       "WORK_EPHEMERAL",
       "WORK_FEEDBACK",
       "WORK_FOR_SALE",
+      "WORK_GARDEN",
       "WORK_LEARNING",
       "WORK_MENTORSHIP",
       "WORK_MULTI_COMPANY",
@@ -123,9 +126,11 @@ module FacebookAds
       "SCHOOL_CLASS",
       "SORORITY",
       "SPORTS",
+      "STREAMER",
       "STUDY_GROUP",
       "SUPPORT",
       "TEAMMATES",
+      "THEME",
       "TRAVEL_PLANNING",
       "WORK_ANNOUNCEMENT",
       "WORK_DEMO_GROUP",
@@ -133,6 +138,7 @@ module FacebookAds
       "WORK_EPHEMERAL",
       "WORK_FEEDBACK",
       "WORK_FOR_SALE",
+      "WORK_GARDEN",
       "WORK_LEARNING",
       "WORK_MENTORSHIP",
       "WORK_MULTI_COMPANY",
@@ -353,6 +359,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'
@@ -521,6 +528,7 @@ module FacebookAds
         api.has_param :scheduled_publish_time, 'int'
         api.has_param :slideshow_spec, 'hash'
         api.has_param :source, 'string'
+        api.has_param :source_instagram_media_id, 'string'
         api.has_param :spherical, 'bool'
         api.has_param :start_offset, 'int'
         api.has_param :swap_mode, { enum: -> { AdVideo::SWAP_MODE }}

data/lib/facebook_ads/ad_objects/home_listing.rb

@@ -39,6 +39,7 @@ module FacebookAds
     field :area_size, 'int'
     field :area_unit, 'string'
     field :availability, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :co_2_emission_rating_eu, 'object'
     field :currency, 'string'
     field :days_on_market, 'int'

data/lib/facebook_ads/ad_objects/hotel.rb

@@ -31,6 +31,7 @@ module FacebookAds
     field :applinks, 'CatalogItemAppLinks'
     field :brand, 'string'
     field :category, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
     field :currency, 'string'
     field :description, 'string'
     field :guest_ratings, 'string'

data/lib/facebook_ads/ad_objects/hotel_room.rb

@@ -38,6 +38,7 @@ module FacebookAds
     field :room_id, 'string'
     field :sale_price, 'string'
     field :url, 'string'
+    has_no_delete
 
     has_edge :pricing_variables do |edge|
       edge.get 'DynamicPriceConfigByDate'

data/lib/facebook_ads/ad_objects/link.rb

@@ -43,6 +43,12 @@ module FacebookAds
     has_no_delete
 
     has_edge :comments do |edge|
+      edge.get 'Comment' do |api|
+        api.has_param :filter, { enum: -> { Comment::FILTER }}
+        api.has_param :live_filter, { enum: -> { Comment::LIVE_FILTER }}
+        api.has_param :order, { enum: -> { Comment::ORDER }}
+        api.has_param :since, 'datetime'
+      end
       edge.post 'Comment' do |api|
         api.has_param :attachment_id, 'string'
         api.has_param :attachment_share_url, 'string'

data/lib/facebook_ads/ad_objects/live_video.rb

@@ -26,6 +26,18 @@ module FacebookAds
   # pull request for this class.
 
   class LiveVideo < AdObject
+    BROADCAST_STATUS = [
+      "live",
+      "live_stopped",
+      "processing",
+      "scheduled_canceled",
+      "scheduled_expired",
+      "scheduled_live",
+      "scheduled_unpublished",
+      "unpublished",
+      "vod",
+    ]
+
     PROJECTION = [
       "CUBEMAP",
       "EQUIRECTANGULAR",
@@ -55,18 +67,6 @@ module FacebookAds
       "REGULAR",
     ]
 
-    BROADCAST_STATUS = [
-      "LIVE",
-      "LIVE_STOPPED",
-      "PROCESSING",
-      "SCHEDULED_CANCELED",
-      "SCHEDULED_EXPIRED",
-      "SCHEDULED_LIVE",
-      "SCHEDULED_UNPUBLISHED",
-      "UNPUBLISHED",
-      "VOD",
-    ]
-
     SOURCE = [
       "owner",
       "target",

data/lib/facebook_ads/ad_objects/page.rb

@@ -113,6 +113,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_JOBS",
       "MANAGE_LEADS",
+      "MESSAGING",
       "MODERATE",
       "MODERATE_COMMUNITY",
       "PAGES_MESSAGING",
@@ -135,6 +136,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_JOBS",
       "MANAGE_LEADS",
+      "MESSAGING",
       "MODERATE",
       "MODERATE_COMMUNITY",
       "PAGES_MESSAGING",
@@ -282,6 +284,7 @@ module FacebookAds
       "leadgen",
       "leadgen_fat",
       "live_videos",
+      "local_delivery",
       "location",
       "mcom_invoice_change",
       "members",
@@ -358,6 +361,7 @@ module FacebookAds
     field :checkins, 'int'
     field :company_overview, 'string'
     field :connected_instagram_account, 'IgUser'
+    field :connected_page_backed_instagram_account, 'IgUser'
     field :contact_address, 'MailingAddress'
     field :copyright_whitelisted_ig_partners, { list: 'string' }
     field :country_page_likes, 'int'
@@ -541,6 +545,13 @@ module FacebookAds
       end
     end
 
+    has_edge :business_data do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :data, { list: 'string' }
+        api.has_param :partner_agent, 'string'
+      end
+    end
+
     has_edge :call_to_actions do |edge|
       edge.get 'PageCallToAction'
     end
@@ -582,9 +593,6 @@ module FacebookAds
         api.has_param :url, 'string'
       end
       edge.get 'Url'
-      edge.post 'Page' do |api|
-        api.has_param :url, 'string'
-      end
     end
 
     has_edge :commerce_merchant_settings do |edge|
@@ -672,6 +680,13 @@ module FacebookAds
       end
     end
 
+    has_edge :extend_thread_control do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :duration, 'int'
+        api.has_param :recipient, 'object'
+      end
+    end
+
     has_edge :feed do |edge|
       edge.get 'PagePost' do |api|
         api.has_param :include_hidden, 'bool'
@@ -896,6 +911,7 @@ module FacebookAds
         api.has_param :crossposting_actions, { list: 'hash' }
         api.has_param :custom_labels, { 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'
@@ -984,13 +1000,9 @@ module FacebookAds
       edge.get 'MessagingFeatureReview'
     end
 
-    has_edge :messenger_ads_page_welcome_messages do |edge|
-      edge.get 'MessengerDestinationPageWelcomeMessage'
-    end
-
     has_edge :messenger_profile do |edge|
       edge.delete do |api|
-        api.has_param :fields, { list: { enum: %w{ACCOUNT_LINKING_URL GET_STARTED GREETING HOME_URL ICE_BREAKERS PAYMENT_SETTINGS PERSISTENT_MENU TARGET_AUDIENCE WHITELISTED_DOMAINS }} }
+        api.has_param :fields, { list: { enum: %w{ACCOUNT_LINKING_URL GET_STARTED GREETING HOME_URL ICE_BREAKERS PAYMENT_SETTINGS PERSISTENT_MENU PLATFORM TARGET_AUDIENCE WHITELISTED_DOMAINS }} }
       end
       edge.get 'MessengerProfile'
       edge.post 'Page' do |api|
@@ -1064,6 +1076,14 @@ module FacebookAds
       end
     end
 
+    has_edge :pass_thread_metadata do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :metadata, 'string'
+        api.has_param :recipient, 'object'
+        api.has_param :target_app_id, 'int'
+      end
+    end
+
     has_edge :personas do |edge|
       edge.get 'Persona'
       edge.post 'Persona' do |api|
@@ -1148,6 +1168,7 @@ module FacebookAds
       end
       edge.post 'ProfilePictureSource' do |api|
         api.has_param :android_key_hash, 'string'
+        api.has_param :burn_media_effect, 'bool'
         api.has_param :caption, 'string'
         api.has_param :composer_session_id, 'string'
         api.has_param :has_umg, 'bool'
@@ -1199,6 +1220,12 @@ module FacebookAds
       edge.get 'Recommendation'
     end
 
+    has_edge :release_thread_control do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :recipient, 'object'
+      end
+    end
+
     has_edge :request_thread_control do |edge|
       edge.post 'Page' do |api|
         api.has_param :metadata, 'string'
@@ -1298,6 +1325,10 @@ module FacebookAds
         api.has_param :selected_rule_id, 'string'
         api.has_param :source, { enum: -> { VideoCopyrightRule::SOURCE }}
       end
+      edge.post 'VideoCopyrightRule' do |api|
+        api.has_param :condition_groups, { list: 'object' }
+        api.has_param :name, 'string'
+      end
     end
 
     has_edge :video_copyrights do |edge|
@@ -1399,6 +1430,7 @@ module FacebookAds
         api.has_param :slideshow_spec, 'hash'
         api.has_param :social_actions, 'bool'
         api.has_param :source, 'string'
+        api.has_param :source_instagram_media_id, 'string'
         api.has_param :specified_dialect, 'string'
         api.has_param :spherical, 'bool'
         api.has_param :sponsor_id, 'string'