facebookbusiness 0.11.0.0 → 0.12.0.0

data/lib/facebook_ads/ad_objects/cloud_game.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 CloudGame < AdObject
+
+    field :id, 'string'
+    field :name, 'string'
+    field :owner, 'Profile'
+    field :playable_ad_file_size, 'int'
+    field :playable_ad_orientation, 'string'
+    field :playable_ad_package_name, 'string'
+    field :playable_ad_reject_reason, 'string'
+    field :playable_ad_status, 'string'
+    field :playable_ad_upload_time, 'datetime'
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb

@@ -48,7 +48,6 @@ module FacebookAds
     field :privacy_url_by_locale, 'hash'
     field :review_rejection_messages, { list: 'string' }
     field :review_rejection_reasons, { list: 'string' }
-    field :review_status, 'string'
     field :supported_card_types, { list: 'string' }
     field :terms, 'string'
     field :terms_url_by_locale, 'hash'

data/lib/facebook_ads/ad_objects/commerce_order.rb

@@ -138,6 +138,7 @@ module FacebookAds
         api.has_param :merchant_order_reference, 'string'
         api.has_param :shipment_origin_postal_code, 'string'
         api.has_param :shipping_tax_details, 'hash'
+        api.has_param :should_use_default_fulfillment_location, 'bool'
         api.has_param :tracking_info, 'hash'
       end
     end

data/lib/facebook_ads/ad_objects/content_delivery_report.rb

@@ -40,7 +40,9 @@ module FacebookAds
     POSITION = [
       "ALL_PLACEMENTS",
       "AN_CLASSIC",
+      "BIZ_DISCO_FEED",
       "FACEBOOK_GROUPS_FEED",
+      "FACEBOOK_REELS",
       "FACEBOOK_STORIES",
       "FEED",
       "GROUPS",
@@ -48,6 +50,7 @@ module FacebookAds
       "INSTAGRAM_EXPLORE",
       "INSTAGRAM_IGTV",
       "INSTAGRAM_REELS",
+      "INSTAGRAM_SHOP",
       "INSTAGRAM_STORIES",
       "INSTANT_ARTICLE",
       "INSTREAM_VIDEO",
@@ -55,7 +58,12 @@ module FacebookAds
       "MARKETPLACE",
       "MESSENGER_INBOX",
       "MESSENGER_STORIES",
+      "OCULUS_REWARDED_VIDEO",
+      "OCULUS_TWILIGHT_DEVELOPER_UPDATE",
       "OCULUS_TWILIGHT_FEED",
+      "OCULUS_TWILIGHT_FEED_SPOTLIGHT",
+      "OCULUS_TWILIGHT_SEARCH",
+      "OCULUS_VR_APPS",
       "OTHERS",
       "REWARDED_VIDEO",
       "RIGHT_HAND_COLUMN",

data/lib/facebook_ads/ad_objects/custom_audience.rb

@@ -44,6 +44,7 @@ module FacebookAds
       "FLIGHT",
       "HOME_LISTING",
       "HOTEL",
+      "JOB",
       "LOCAL_SERVICE_BUSINESS",
       "LOCATION_BASED_ITEM",
       "MEDIA_TITLE",
@@ -100,6 +101,7 @@ module FacebookAds
     field :name, 'string'
     field :operation_status, 'CustomAudienceStatus'
     field :opt_out_link, 'string'
+    field :page_deletion_marked_delete_time, 'int'
     field :permission_for_actions, 'AudiencePermissionForActions'
     field :pixel_id, 'string'
     field :regulated_audience_spec, 'LookalikeSpec'

data/lib/facebook_ads/ad_objects/destination.rb

@@ -50,6 +50,7 @@ module FacebookAds
     field :price_change, 'string'
     field :sanitized_images, { list: 'string' }
     field :types, { list: 'string' }
+    field :unit_price, 'object'
     field :url, 'string'
     has_no_post
     has_no_delete

data/lib/facebook_ads/ad_objects/event.rb

@@ -87,6 +87,7 @@ module FacebookAds
     field :can_guests_invite, 'bool'
     field :category, { enum: -> { CATEGORY }}
     field :cover, 'CoverPhoto'
+    field :created_time, 'datetime'
     field :declined_count, 'int'
     field :description, 'string'
     field :discount_code_enabled, 'bool'
@@ -140,7 +141,6 @@ module FacebookAds
         api.has_param :is_spherical, 'bool'
         api.has_param :live_encoders, { list: 'string' }
         api.has_param :original_fov, 'int'
-        api.has_param :planned_start_time, 'int'
         api.has_param :privacy, 'string'
         api.has_param :projection, { enum: -> { LiveVideo::PROJECTION }}
         api.has_param :published, 'bool'

data/lib/facebook_ads/ad_objects/flight.rb

@@ -52,6 +52,7 @@ module FacebookAds
     field :origin_city, 'string'
     field :price, 'string'
     field :sanitized_images, { list: 'string' }
+    field :unit_price, 'object'
     field :url, 'string'
     has_no_delete
 

data/lib/facebook_ads/ad_objects/group.rb

@@ -49,6 +49,7 @@ module FacebookAds
       "EPHEMERAL",
       "EVENT_PLANNING",
       "FAMILY",
+      "FANTASY_LEAGUE",
       "FITNESS",
       "FOR_SALE",
       "FOR_WORK",
@@ -105,6 +106,7 @@ module FacebookAds
       "EPHEMERAL",
       "EVENT_PLANNING",
       "FAMILY",
+      "FANTASY_LEAGUE",
       "FITNESS",
       "FOR_SALE",
       "FOR_WORK",
@@ -367,7 +369,6 @@ module FacebookAds
         api.has_param :is_spherical, 'bool'
         api.has_param :live_encoders, { list: 'string' }
         api.has_param :original_fov, 'int'
-        api.has_param :planned_start_time, 'int'
         api.has_param :privacy, 'string'
         api.has_param :projection, { enum: -> { LiveVideo::PROJECTION }}
         api.has_param :published, 'bool'
@@ -466,6 +467,13 @@ module FacebookAds
       end
     end
 
+    has_edge :shift_settings do |edge|
+      edge.post do |api|
+        api.has_param :external_id, 'string'
+        api.has_param :shift_feature_setting, { enum: %w{ALL_FEATURES_OFF ALL_FEATURES_ON SHIFT_COVER_ONLY_ON SHIFT_VIEWER_ONLY_ON }}
+      end
+    end
+
     has_edge :videos do |edge|
       edge.get 'AdVideo' do |api|
         api.has_param :type, { enum: -> { AdVideo::TYPE }}
@@ -520,6 +528,7 @@ module FacebookAds
         api.has_param :original_fov, 'int'
         api.has_param :original_projection_type, { enum: -> { AdVideo::ORIGINAL_PROJECTION_TYPE }}
         api.has_param :publish_event_id, 'int'
+        api.has_param :published, 'bool'
         api.has_param :react_mode_metadata, 'string'
         api.has_param :referenced_sticker_id, 'string'
         api.has_param :replace_video_id, 'string'

data/lib/facebook_ads/ad_objects/home_listing.rb

@@ -78,6 +78,7 @@ module FacebookAds
     field :price, 'string'
     field :property_type, 'string'
     field :sanitized_images, { list: 'string' }
+    field :unit_price, 'object'
     field :url, 'string'
     field :year_built, 'int'
 

data/lib/facebook_ads/ad_objects/hotel.rb

@@ -56,6 +56,7 @@ module FacebookAds
     field :sale_price, 'string'
     field :sanitized_images, { list: 'string' }
     field :star_rating, 'double'
+    field :unit_price, 'object'
     field :url, 'string'
     field :base_price, 'int'
 

data/lib/facebook_ads/ad_objects/invoice_campaign.rb

@@ -33,6 +33,7 @@ module FacebookAds
     field :campaign_name, 'string'
     field :clicks, 'int'
     field :conversions, 'int'
+    field :description, 'string'
     field :impressions, 'int'
     field :tags, { list: 'string' }
     has_no_id

data/lib/facebook_ads/ad_objects/jobs_job.rb

@@ -0,0 +1,72 @@
+# 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 JobsJob < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
+
+    field :address, 'object'
+    field :applinks, 'CatalogItemAppLinks'
+    field :category_specific_fields, 'CatalogSubVerticalList'
+    field :custom_label_0, 'string'
+    field :custom_label_1, 'string'
+    field :custom_label_2, 'string'
+    field :custom_label_3, 'string'
+    field :custom_label_4, 'string'
+    field :custom_label_5, 'string'
+    field :custom_label_6, 'string'
+    field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
+    field :images, { list: 'string' }
+    field :jobs_job_id, 'string'
+    field :sanitized_images, { list: 'string' }
+    field :unit_price, 'object'
+    field :url, 'string'
+    has_no_post
+    has_no_delete
+
+    has_edge :augmented_realities_metadata do |edge|
+      edge.get
+    end
+
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
+    has_edge :videos_metadata do |edge|
+      edge.get
+    end
+
+  end
+end

data/lib/facebook_ads/ad_objects/live_video.rb

@@ -75,11 +75,14 @@ module FacebookAds
     LIVE_COMMENT_MODERATION_SETTING = [
       "DEFAULT",
       "DISCUSSION",
+      "FOLLOWED",
       "FOLLOWER",
+      "NO_HYPERLINK",
       "PROTECTED_MODE",
       "RESTRICTED",
       "SLOW",
       "SUPPORTER",
+      "TAGGED",
     ]
 
     PERSISTENT_STREAM_KEY_STATUS = [
@@ -97,7 +100,7 @@ module FacebookAds
     field :dash_ingest_url, 'string'
     field :dash_preview_url, 'string'
     field :description, 'string'
-    field :embed_html, 'string'
+    field :embed_html, 'object'
     field :from, 'object'
     field :id, 'string'
     field :ingest_streams, { list: 'LiveVideoInputStream' }

data/lib/facebook_ads/ad_objects/local_service_business.rb

@@ -0,0 +1,65 @@
+# 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 LocalServiceBusiness < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
+
+    field :applinks, 'CatalogItemAppLinks'
+    field :brand, 'string'
+    field :category_specific_fields, 'CatalogSubVerticalList'
+    field :currency, 'string'
+    field :custom_label_0, 'string'
+    field :custom_label_1, 'string'
+    field :custom_label_2, 'string'
+    field :custom_label_3, 'string'
+    field :custom_label_4, 'string'
+    field :description, 'string'
+    field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
+    field :images, { list: 'string' }
+    field :local_service_business_id, 'string'
+    field :price, 'string'
+    field :sanitized_images, { list: 'string' }
+    field :title, 'string'
+    field :url, 'string'
+    has_no_post
+    has_no_delete
+
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
+  end
+end

data/lib/facebook_ads/ad_objects/managed_partner_business.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 ManagedPartnerBusiness < AdObject
+
+    field :ad_account, 'AdAccount'
+    field :catalog_segment, 'ProductCatalog'
+    field :extended_credit, 'ExtendedCredit'
+    field :page, 'Page'
+    field :seller_business_info, 'object'
+    field :seller_business_status, 'string'
+    field :template, { list: 'object' }
+    has_no_id
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/messenger_destination_page_welcome_message.rb

@@ -33,6 +33,7 @@ module FacebookAds
     field :template_name, 'string'
     field :time_created, 'datetime'
     field :time_last_used, 'datetime'
+    has_no_get
     has_no_post
     has_no_delete
 

data/lib/facebook_ads/ad_objects/omega_customer_trx.rb

@@ -35,6 +35,7 @@ module FacebookAds
 
 
     field :ad_account_ids, { list: 'string' }
+    field :advertiser_name, 'string'
     field :amount, 'string'
     field :amount_due, 'CurrencyAmount'
     field :billed_amount_details, 'BilledAmountDetails'

data/lib/facebook_ads/ad_objects/page.rb

@@ -126,6 +126,7 @@ module FacebookAds
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
+      "PROFILE_PLUS_REVENUE",
       "READ_PAGE_MAILBOXES",
       "VIEW_MONETIZATION_INSIGHTS",
     ]
@@ -151,10 +152,46 @@ module FacebookAds
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
+      "PROFILE_PLUS_REVENUE",
       "READ_PAGE_MAILBOXES",
       "VIEW_MONETIZATION_INSIGHTS",
     ]
 
+    ALIGNMENT = [
+      "LEFT",
+      "RIGHT",
+    ]
+
+    ENTRY_POINT_ICON = [
+      "CHAT_ANGULAR_ICON",
+      "CHAT_ROUND_ICON",
+      "MESSENGER_ICON",
+      "NONE",
+    ]
+
+    ENTRY_POINT_LABEL = [
+      "ASK_US",
+      "CHAT",
+      "HELP",
+      "NONE",
+    ]
+
+    GREETING_DIALOG_DISPLAY = [
+      "HIDE",
+      "SHOW",
+      "WELCOME_MESSAGE",
+    ]
+
+    GUEST_CHAT_MODE = [
+      "DISABLED",
+      "ENABLED",
+    ]
+
+    MOBILE_CHAT_DISPLAY = [
+      "APP_SWITCH",
+      "CHAT_TAB",
+    ]
+
     BACKDATED_TIME_GRANULARITY = [
       "day",
       "hour",
@@ -308,6 +345,7 @@ module FacebookAds
       "messaging_account_linking",
       "messaging_appointments",
       "messaging_checkout_updates",
+      "messaging_customer_information",
       "messaging_direct_sends",
       "messaging_fblogin_account_linking",
       "messaging_feedback",
@@ -541,10 +579,6 @@ module FacebookAds
       end
     end
 
-    has_edge :audio_isrcs do |edge|
-      edge.get
-    end
-
     has_edge :blocked do |edge|
       edge.delete do |api|
         api.has_param :asid, 'string'
@@ -565,19 +599,18 @@ module FacebookAds
     end
 
     has_edge :business_data do |edge|
-      edge.delete do |api|
-        api.has_param :email, 'string'
-        api.has_param :external_id, 'string'
-        api.has_param :object_name, { enum: %w{contact order order_item }}
-        api.has_param :order_id, 'string'
-        api.has_param :order_item_id, 'string'
-      end
       edge.post 'Page' do |api|
         api.has_param :data, { list: 'string' }
         api.has_param :partner_agent, 'string'
       end
     end
 
+    has_edge :businessprojects do |edge|
+      edge.get do |api|
+        api.has_param :business, 'string'
+      end
+    end
+
     has_edge :call_to_actions do |edge|
       edge.get 'PageCallToAction'
     end
@@ -615,6 +648,24 @@ module FacebookAds
       end
     end
 
+    has_edge :chat_plugin do |edge|
+      edge.get 'ChatPlugin'
+      edge.post 'Page' do |api|
+        api.has_param :alignment, { enum: -> { Page::ALIGNMENT }}
+        api.has_param :desktop_bottom_spacing, 'int'
+        api.has_param :desktop_side_spacing, 'int'
+        api.has_param :entry_point_icon, { enum: -> { Page::ENTRY_POINT_ICON }}
+        api.has_param :entry_point_label, { enum: -> { Page::ENTRY_POINT_LABEL }}
+        api.has_param :greeting_dialog_display, { enum: -> { Page::GREETING_DIALOG_DISPLAY }}
+        api.has_param :guest_chat_mode, { enum: -> { Page::GUEST_CHAT_MODE }}
+        api.has_param :mobile_bottom_spacing, 'int'
+        api.has_param :mobile_chat_display, { enum: -> { Page::MOBILE_CHAT_DISPLAY }}
+        api.has_param :mobile_side_spacing, 'int'
+        api.has_param :theme_color, 'string'
+        api.has_param :welcome_screen_greeting, 'string'
+      end
+    end
+
     has_edge :claimed_urls do |edge|
       edge.get 'Url'
     end
@@ -683,6 +734,7 @@ module FacebookAds
       edge.get 'PageUserMessageThreadLabel'
       edge.post 'PageUserMessageThreadLabel' do |api|
         api.has_param :name, 'string'
+        api.has_param :page_label_name, 'string'
       end
     end
 
@@ -881,6 +933,13 @@ module FacebookAds
       end
     end
 
+    has_edge :insights_exports do |edge|
+      edge.get do |api|
+        api.has_param :data_level, { list: 'string' }
+        api.has_param :from_creation_date, 'datetime'
+      end
+    end
+
     has_edge :instagram_accounts do |edge|
       edge.get 'InstagramUser'
     end
@@ -971,7 +1030,6 @@ module FacebookAds
         api.has_param :is_spherical, 'bool'
         api.has_param :live_encoders, { list: 'string' }
         api.has_param :original_fov, 'int'
-        api.has_param :planned_start_time, 'int'
         api.has_param :privacy, 'string'
         api.has_param :projection, { enum: -> { LiveVideo::PROJECTION }}
         api.has_param :published, 'bool'