facebookbusiness 0.8.0.0 → 0.8.0.2

data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb

@@ -26,6 +26,11 @@ module FacebookAds
   # pull request for this class.
 
   class CommerceMerchantSettings < AdObject
+    CTA = [
+      "CONTACT_MERCHANT",
+      "OFFSITE_LINK",
+    ]
+
     MERCHANT_STATUS = [
       "ENABLED",
       "EXTERNALLY_DISABLED",
@@ -35,6 +40,7 @@ module FacebookAds
     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 :facebook_channel, 'object'
@@ -92,6 +98,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_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

@@ -68,5 +68,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

@@ -73,6 +73,7 @@ module FacebookAds
       "STUDY_GROUP",
       "SUPPORT",
       "TEAMMATES",
+      "THEME",
       "TRAVEL_PLANNING",
       "WORK_ANNOUNCEMENT",
       "WORK_DEMO_GROUP",
@@ -80,6 +81,7 @@ module FacebookAds
       "WORK_EPHEMERAL",
       "WORK_FEEDBACK",
       "WORK_FOR_SALE",
+      "WORK_GARDEN",
       "WORK_LEARNING",
       "WORK_MENTORSHIP",
       "WORK_MULTI_COMPANY",
@@ -126,6 +128,7 @@ module FacebookAds
       "STUDY_GROUP",
       "SUPPORT",
       "TEAMMATES",
+      "THEME",
       "TRAVEL_PLANNING",
       "WORK_ANNOUNCEMENT",
       "WORK_DEMO_GROUP",
@@ -133,6 +136,7 @@ module FacebookAds
       "WORK_EPHEMERAL",
       "WORK_FEEDBACK",
       "WORK_FOR_SALE",
+      "WORK_GARDEN",
       "WORK_LEARNING",
       "WORK_MENTORSHIP",
       "WORK_MULTI_COMPANY",
@@ -353,6 +357,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/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/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",
@@ -120,6 +121,7 @@ module FacebookAds
       "PROFILE_PLUS_ADVERTISE",
       "PROFILE_PLUS_ANALYZE",
       "PROFILE_PLUS_CREATE_CONTENT",
+      "PROFILE_PLUS_LIVE_STREAM_MODERATION",
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
@@ -135,6 +137,7 @@ module FacebookAds
       "MANAGE",
       "MANAGE_JOBS",
       "MANAGE_LEADS",
+      "MESSAGING",
       "MODERATE",
       "MODERATE_COMMUNITY",
       "PAGES_MESSAGING",
@@ -142,6 +145,7 @@ module FacebookAds
       "PROFILE_PLUS_ADVERTISE",
       "PROFILE_PLUS_ANALYZE",
       "PROFILE_PLUS_CREATE_CONTENT",
+      "PROFILE_PLUS_LIVE_STREAM_MODERATION",
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
@@ -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
@@ -672,6 +683,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 +914,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'
@@ -990,7 +1009,7 @@ module FacebookAds
 
     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|
@@ -1148,6 +1167,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'

data/lib/facebook_ads/ad_objects/page_post.rb

@@ -76,6 +76,7 @@ module FacebookAds
     field :id, 'string'
     field :implicit_place, 'Place'
     field :instagram_eligibility, 'string'
+    field :instream_eligibility, 'string'
     field :is_app_share, 'bool'
     field :is_eligible_for_promotion, 'bool'
     field :is_expired, 'bool'
@@ -94,6 +95,7 @@ module FacebookAds
     field :permalink_url, 'object'
     field :picture, 'string'
     field :place, 'Place'
+    field :poll, 'object'
     field :privacy, 'Privacy'
     field :promotable_id, 'string'
     field :promotion_status, 'string'

data/lib/facebook_ads/ad_objects/photo.rb

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

data/lib/facebook_ads/ad_objects/post.rb

@@ -74,6 +74,7 @@ module FacebookAds
     field :id, 'string'
     field :implicit_place, 'Place'
     field :instagram_eligibility, 'string'
+    field :instream_eligibility, 'string'
     field :is_app_share, 'bool'
     field :is_eligible_for_promotion, 'bool'
     field :is_expired, 'bool'
@@ -95,6 +96,7 @@ module FacebookAds
     field :permalink_url, 'object'
     field :picture, 'string'
     field :place, 'Place'
+    field :poll, 'object'
     field :privacy, 'Privacy'
     field :promotable_id, 'string'
     field :promotion_status, 'string'
@@ -174,7 +176,7 @@ module FacebookAds
       edge.post do |api|
         api.has_param :ad_account_id, 'string'
         api.has_param :ad_conversion_pixel_id, 'int'
-        api.has_param :audience, { enum: %w{AUTO_LOOKALIKE AUTO_PAGE_LOOKALIKE AUTO_TARGETING COUNTRY_AND_INTEREST CREATE_NEW CUSTOM_AUDIENCE DISTRICT EVENT_CUSTOM_AUDIENCES EVENT_ENGAGEMENT FANS GROUPER HEC_AUDIENCE IG_PROMOTED_POST_AUTO LOCAL LOOKALIKE MARKETPLACE_DEFAULT MULT_CUSTOM_AUDIENCES NCPP SAVED_AUDIENCE SMART_AUDIENCE }}
+        api.has_param :audience, { enum: %w{AUTO_LOOKALIKE AUTO_PAGE_LOOKALIKE AUTO_TARGETING COUNTRY_AND_INTEREST CREATE_NEW CUSTOM_AUDIENCE DISTRICT EVENT_CUSTOM_AUDIENCES EVENT_ENGAGEMENT FANS GROUPER HEC_AUDIENCE IG_PROMOTED_POST_AUTO LOCAL LOOKALIKE MARKETPLACE_DEFAULT MARKETPLACE_NATIONWIDE_AUDIENCE MARKETPLACE_SAVED_AUDIENCE MULT_CUSTOM_AUDIENCES NCPP SAVED_AUDIENCE SMART_AUDIENCE }}
         api.has_param :audience_id, 'string'
         api.has_param :bid_amount, 'int'
         api.has_param :budget, 'int'