facebookbusiness 0.10.0.1 → 0.11.0.0

data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb

@@ -56,6 +56,37 @@ module FacebookAds
     has_no_post
     has_no_delete
 
+    has_edge :acknowledge_orders do |edge|
+      edge.post 'CommerceMerchantSettings' do |api|
+        api.has_param :idempotency_key, 'string'
+        api.has_param :orders, { list: 'hash' }
+      end
+    end
+
+    has_edge :commerce_orders do |edge|
+      edge.get 'CommerceOrder' do |api|
+        api.has_param :filters, { list: { enum: -> { CommerceOrder::FILTERS }} }
+        api.has_param :state, { list: { enum: -> { CommerceOrder::STATE }} }
+        api.has_param :updated_after, 'datetime'
+        api.has_param :updated_before, 'datetime'
+      end
+    end
+
+    has_edge :commerce_payouts do |edge|
+      edge.get 'CommercePayout' do |api|
+        api.has_param :end_time, 'datetime'
+        api.has_param :start_time, 'datetime'
+      end
+    end
+
+    has_edge :commerce_transactions do |edge|
+      edge.get 'CommerceOrderTransactionDetail' do |api|
+        api.has_param :end_time, 'datetime'
+        api.has_param :payout_reference_id, 'string'
+        api.has_param :start_time, 'datetime'
+      end
+    end
+
     has_edge :order_management_apps do |edge|
       edge.get 'Application'
       edge.post 'CommerceMerchantSettings'

data/lib/facebook_ads/ad_objects/commerce_order.rb

@@ -26,19 +26,6 @@ module FacebookAds
   # pull request for this class.
 
   class CommerceOrder < AdObject
-    REASON_CODE = [
-      "BUYERS_REMORSE",
-      "DAMAGED_GOODS",
-      "NOT_AS_DESCRIBED",
-      "QUALITY_ISSUE",
-      "REFUND_COMPROMISED",
-      "REFUND_FOR_RETURN",
-      "REFUND_REASON_OTHER",
-      "REFUND_SFI_FAKE",
-      "REFUND_SFI_REAL",
-      "WRONG_ITEM",
-    ]
-
     FILTERS = [
       "HAS_CANCELLATIONS",
       "HAS_FULFILLMENTS",
@@ -55,6 +42,20 @@ module FacebookAds
       "IN_PROGRESS",
     ]
 
+    REASON_CODE = [
+      "BUYERS_REMORSE",
+      "DAMAGED_GOODS",
+      "FACEBOOK_INITIATED",
+      "NOT_AS_DESCRIBED",
+      "QUALITY_ISSUE",
+      "REFUND_COMPROMISED",
+      "REFUND_FOR_RETURN",
+      "REFUND_REASON_OTHER",
+      "REFUND_SFI_FAKE",
+      "REFUND_SFI_REAL",
+      "WRONG_ITEM",
+    ]
+
 
     field :buyer_details, 'object'
     field :channel, 'string'

data/lib/facebook_ads/ad_objects/custom_audience.rb

@@ -84,6 +84,7 @@ module FacebookAds
     field :data_source, 'CustomAudienceDataSource'
     field :data_source_types, 'string'
     field :datafile_custom_audience_uploading_status, 'string'
+    field :delete_time, 'int'
     field :delivery_status, 'CustomAudienceStatus'
     field :description, 'string'
     field :excluded_custom_audiences, { list: 'CustomAudience' }

data/lib/facebook_ads/ad_objects/destination.rb

@@ -58,6 +58,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
     has_edge :videos_metadata do |edge|
       edge.get
     end

data/lib/facebook_ads/ad_objects/event.rb

@@ -170,6 +170,10 @@ module FacebookAds
       edge.get 'Profile'
     end
 
+    has_edge :ticket_tiers do |edge|
+      edge.get
+    end
+
     has_edge :videos do |edge|
       edge.get 'NullNode'
     end

data/lib/facebook_ads/ad_objects/flight.rb

@@ -59,6 +59,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
     has_edge :videos_metadata do |edge|
       edge.get
     end

data/lib/facebook_ads/ad_objects/group.rb

@@ -351,14 +351,6 @@ module FacebookAds
       end
     end
 
-    has_edge :important_posts do |edge|
-      edge.post do |api|
-        api.has_param :button_type, { enum: %w{DISMISS DONE MARK_AS_READ }}
-        api.has_param :expiration_time, 'datetime'
-        api.has_param :post_id, 'string'
-      end
-    end
-
     has_edge :live_videos do |edge|
       edge.get 'LiveVideo' do |api|
         api.has_param :broadcast_status, { list: { enum: -> { LiveVideo::BROADCAST_STATUS }} }
@@ -474,15 +466,6 @@ module FacebookAds
       end
     end
 
-    has_edge :pinned_posts do |edge|
-      edge.delete do |api|
-        api.has_param :post_id, 'string'
-      end
-      edge.post 'Post' do |api|
-        api.has_param :post_ids, { list: 'string' }
-      end
-    end
-
     has_edge :videos do |edge|
       edge.get 'AdVideo' do |api|
         api.has_param :type, { enum: -> { AdVideo::TYPE }}

data/lib/facebook_ads/ad_objects/home_listing.rb

@@ -85,6 +85,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
     has_edge :videos_metadata do |edge|
       edge.get
     end

data/lib/facebook_ads/ad_objects/hotel.rb

@@ -63,6 +63,10 @@ module FacebookAds
       edge.get
     end
 
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
     has_edge :hotel_rooms do |edge|
       edge.get 'HotelRoom'
     end

data/lib/facebook_ads/ad_objects/ig_user.rb

@@ -60,7 +60,10 @@ module FacebookAds
     end
 
     has_edge :media do |edge|
-      edge.get 'IgMedia'
+      edge.get 'IgMedia' do |api|
+        api.has_param :since, 'datetime'
+        api.has_param :until, 'datetime'
+      end
       edge.post 'IgMedia' do |api|
         api.has_param :caption, 'string'
         api.has_param :image_url, 'string'

data/lib/facebook_ads/ad_objects/{invoice_campaign_new.rb → invoice_campaign.rb}

@@ -25,7 +25,7 @@ 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 InvoiceCampaignNew < AdObject
+  class InvoiceCampaign < AdObject
 
     field :ad_account_id, 'string'
     field :billed_amount_details, 'BilledAmountDetails'

data/lib/facebook_ads/ad_objects/omega_customer_trx.rb

@@ -57,7 +57,7 @@ module FacebookAds
     has_no_delete
 
     has_edge :campaigns do |edge|
-      edge.get 'InvoiceCampaignNew'
+      edge.get 'InvoiceCampaign'
     end
 
   end

data/lib/facebook_ads/ad_objects/oracle_transaction.rb

@@ -49,7 +49,7 @@ module FacebookAds
     has_no_delete
 
     has_edge :campaigns do |edge|
-      edge.get 'InvoiceCampaignNew'
+      edge.get 'InvoiceCampaign'
     end
 
   end

data/lib/facebook_ads/ad_objects/page.rb

@@ -122,6 +122,7 @@ module FacebookAds
       "PROFILE_PLUS_ANALYZE",
       "PROFILE_PLUS_CREATE_CONTENT",
       "PROFILE_PLUS_FACEBOOK_ACCESS",
+      "PROFILE_PLUS_FULL_CONTROL",
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
@@ -146,6 +147,7 @@ module FacebookAds
       "PROFILE_PLUS_ANALYZE",
       "PROFILE_PLUS_CREATE_CONTENT",
       "PROFILE_PLUS_FACEBOOK_ACCESS",
+      "PROFILE_PLUS_FULL_CONTROL",
       "PROFILE_PLUS_MANAGE",
       "PROFILE_PLUS_MESSAGING",
       "PROFILE_PLUS_MODERATE",
@@ -232,6 +234,11 @@ module FacebookAds
       "UNREACT",
     ]
 
+    PLATFORM = [
+      "INSTAGRAM",
+      "MESSENGER",
+    ]
+
     MODEL = [
       "ARABIC",
       "CHINESE",
@@ -534,6 +541,10 @@ 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'
@@ -600,6 +611,7 @@ module FacebookAds
         api.has_param :is_hidden, 'bool'
         api.has_param :is_published, 'bool'
         api.has_param :name, 'string'
+        api.has_param :source_template_id, 'string'
       end
     end
 
@@ -642,6 +654,7 @@ module FacebookAds
     has_edge :conversations do |edge|
       edge.get 'UnifiedThread' do |api|
         api.has_param :folder, 'string'
+        api.has_param :platform, { enum: -> { UnifiedThread::PLATFORM }}
         api.has_param :tags, { list: 'string' }
         api.has_param :user_id, 'string'
       end
@@ -831,6 +844,13 @@ module FacebookAds
       edge.get 'Page'
     end
 
+    has_edge :groups do |edge|
+      edge.get 'Group' do |api|
+        api.has_param :admin_only, 'bool'
+        api.has_param :parent, 'string'
+      end
+    end
+
     has_edge :image_copyrights do |edge|
       edge.get 'ImageCopyright'
       edge.post 'ImageCopyright' do |api|
@@ -1020,6 +1040,7 @@ module FacebookAds
         api.has_param :message, 'object'
         api.has_param :messaging_type, { enum: -> { Page::MESSAGING_TYPE }}
         api.has_param :notification_type, { enum: -> { Page::NOTIFICATION_TYPE }}
+        api.has_param :payload, 'string'
         api.has_param :persona_id, 'string'
         api.has_param :recipient, 'object'
         api.has_param :sender_action, { enum: -> { Page::SENDER_ACTION }}
@@ -1034,8 +1055,11 @@ 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 PLATFORM SUBJECT_TO_NEW_EU_PRIVACY_RULES TARGET_AUDIENCE WHITELISTED_DOMAINS }} }
+        api.has_param :platform, { enum: -> { Page::PLATFORM }}
+      end
+      edge.get 'MessengerProfile' do |api|
+        api.has_param :platform, { enum: -> { Page::PLATFORM }}
       end
-      edge.get 'MessengerProfile'
       edge.post 'Page' do |api|
         api.has_param :account_linking_url, 'string'
         api.has_param :get_started, 'object'
@@ -1043,6 +1067,7 @@ module FacebookAds
         api.has_param :ice_breakers, { list: 'hash' }
         api.has_param :payment_settings, 'object'
         api.has_param :persistent_menu, { list: 'object' }
+        api.has_param :platform, { enum: -> { Page::PLATFORM }}
         api.has_param :target_audience, 'object'
         api.has_param :whitelisted_domains, { list: 'string' }
       end
@@ -1123,13 +1148,6 @@ module FacebookAds
       end
     end
 
-    has_edge :phone_data do |edge|
-      edge.post do |api|
-        api.has_param :call_ads_phone_data_use_case, { enum: %w{CALL_DESTINATION_AD CALL_EXTENSION_AD }}
-        api.has_param :phone_number, 'string'
-      end
-    end
-
     has_edge :photos do |edge|
       edge.get 'Photo' do |api|
         api.has_param :biz_tag_id, 'int'
@@ -1209,6 +1227,7 @@ module FacebookAds
         api.has_param :burn_media_effect, 'bool'
         api.has_param :caption, 'string'
         api.has_param :composer_session_id, 'string'
+        api.has_param :frame_entrypoint, 'string'
         api.has_param :has_umg, 'bool'
         api.has_param :height, 'int'
         api.has_param :ios_bundle_id, 'string'
@@ -1289,7 +1308,9 @@ module FacebookAds
     end
 
     has_edge :secondary_receivers do |edge|
-      edge.get 'Application'
+      edge.get 'Application' do |api|
+        api.has_param :platform, { enum: -> { Application::PLATFORM }}
+      end
     end
 
     has_edge :settings do |edge|
@@ -1501,5 +1522,18 @@ module FacebookAds
       end
     end
 
+    has_edge :workpagemessages do |edge|
+      edge.post 'Page' do |api|
+        api.has_param :message, 'object'
+        api.has_param :messaging_type, { enum: -> { Page::MESSAGING_TYPE }}
+        api.has_param :notification_type, { enum: -> { Page::NOTIFICATION_TYPE }}
+        api.has_param :payload, 'string'
+        api.has_param :persona_id, 'string'
+        api.has_param :recipient, 'object'
+        api.has_param :sender_action, { enum: -> { Page::SENDER_ACTION }}
+        api.has_param :tag, 'object'
+      end
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/page_call_to_action.rb

@@ -33,6 +33,7 @@ module FacebookAds
       "FACEBOOK_APP",
       "FOLLOW",
       "MARKETPLACE_INVENTORY_PAGE",
+      "MENU_ON_FACEBOOK",
       "MESSENGER",
       "MINI_SHOP",
       "MOBILE_CENTER",
@@ -49,6 +50,7 @@ module FacebookAds
       "FACEBOOK_APP",
       "FOLLOW",
       "MARKETPLACE_INVENTORY_PAGE",
+      "MENU_ON_FACEBOOK",
       "MESSENGER",
       "MINI_SHOP",
       "NONE",
@@ -88,6 +90,7 @@ module FacebookAds
       "SHOP_ON_FACEBOOK",
       "SIGN_UP",
       "VIEW_INVENTORY",
+      "VIEW_MENU",
       "VIEW_SHOP",
       "VISIT_GROUP",
       "WATCH_NOW",

data/lib/facebook_ads/ad_objects/product_catalog.rb

@@ -112,6 +112,7 @@ module FacebookAds
     field :destination_catalog_settings, 'hash'
     field :flight_catalog_settings, 'hash'
     field :parent_catalog_id, 'string'
+    field :partner_integration, 'hash'
 
     has_edge :agencies do |edge|
       edge.delete do |api|
@@ -203,6 +204,15 @@ module FacebookAds
       end
     end
 
+    has_edge :diagnostics do |edge|
+      edge.get 'ProductCatalogDiagnosticGroup' do |api|
+        api.has_param :affected_channels, { list: { enum: -> { ProductCatalogDiagnosticGroup::AFFECTED_CHANNELS }} }
+        api.has_param :affected_features, { list: { enum: -> { ProductCatalogDiagnosticGroup::AFFECTED_FEATURES }} }
+        api.has_param :severities, { list: { enum: -> { ProductCatalogDiagnosticGroup::SEVERITIES }} }
+        api.has_param :types, { list: { enum: -> { ProductCatalogDiagnosticGroup::TYPES }} }
+      end
+    end
+
     has_edge :event_stats do |edge|
       edge.get 'ProductEventStat' do |api|
         api.has_param :breakdowns, { list: { enum: -> { ProductEventStat::BREAKDOWNS }} }
@@ -211,11 +221,11 @@ module FacebookAds
 
     has_edge :external_event_sources do |edge|
       edge.delete do |api|
-        api.has_param :external_event_sources, { list: 'string' }
+        api.has_param :external_event_sources, 'object'
       end
       edge.get 'ExternalEventSource'
       edge.post 'ProductCatalog' do |api|
-        api.has_param :external_event_sources, { list: 'string' }
+        api.has_param :external_event_sources, 'object'
       end
     end
 
@@ -295,6 +305,14 @@ module FacebookAds
       end
     end
 
+    has_edge :localized_items_batch do |edge|
+      edge.post 'ProductCatalog' do |api|
+        api.has_param :allow_upsert, 'bool'
+        api.has_param :item_type, 'string'
+        api.has_param :requests, 'hash'
+      end
+    end
+
     has_edge :media_titles do |edge|
       edge.get do |api|
         api.has_param :bulk_pagination, 'bool'
@@ -415,6 +433,7 @@ module FacebookAds
         api.has_param :iphone_url, 'string'
         api.has_param :launch_date, 'string'
         api.has_param :manufacturer_part_number, 'string'
+        api.has_param :marked_for_product_launch, { enum: -> { ProductItem::MARKED_FOR_PRODUCT_LAUNCH }}
         api.has_param :material, 'string'
         api.has_param :mobile_link, 'string'
         api.has_param :name, 'string'
@@ -425,6 +444,7 @@ module FacebookAds
         api.has_param :pattern, 'string'
         api.has_param :price, 'int'
         api.has_param :product_type, 'string'
+        api.has_param :quantity_to_sell_on_facebook, 'int'
         api.has_param :retailer_id, 'string'
         api.has_param :retailer_product_group_id, 'string'
         api.has_param :return_policy_days, 'int'