facebookbusiness 0.3.2.8 → 0.3.2.9

data/lib/facebook_ads/ad_objects/lead_gen_data_draft.rb

@@ -27,37 +27,37 @@ module FacebookAds
 
   class LeadGenDataDraft < AdObject
     LOCALE = [
-      "EN_US",
-      "IT_IT",
-      "FR_FR",
-      "ES_ES",
-      "ES_LA",
-      "DE_DE",
-      "EN_GB",
-      "PT_BR",
-      "ZH_TW",
-      "ZH_HK",
-      "TR_TR",
       "AR_AR",
       "CS_CZ",
       "DA_DK",
+      "DE_DE",
+      "EN_GB",
+      "EN_US",
+      "ES_ES",
+      "ES_LA",
       "FI_FI",
+      "FR_FR",
       "HE_IL",
       "HI_IN",
       "HU_HU",
       "ID_ID",
+      "IT_IT",
       "JA_JP",
       "KO_KR",
       "NB_NO",
       "NL_NL",
       "PL_PL",
+      "PT_BR",
       "PT_PT",
       "RO_RO",
       "RU_RU",
       "SV_SE",
       "TH_TH",
+      "TR_TR",
       "VI_VN",
       "ZH_CN",
+      "ZH_HK",
+      "ZH_TW",
     ]
 
     STATUS = [

data/lib/facebook_ads/ad_objects/leadgen_form.rb

@@ -34,37 +34,37 @@ module FacebookAds
     ]
 
     LOCALE = [
-      "EN_US",
-      "IT_IT",
-      "FR_FR",
-      "ES_ES",
-      "ES_LA",
-      "DE_DE",
-      "EN_GB",
-      "PT_BR",
-      "ZH_TW",
-      "ZH_HK",
-      "TR_TR",
       "AR_AR",
       "CS_CZ",
       "DA_DK",
+      "DE_DE",
+      "EN_GB",
+      "EN_US",
+      "ES_ES",
+      "ES_LA",
       "FI_FI",
+      "FR_FR",
       "HE_IL",
       "HI_IN",
       "HU_HU",
       "ID_ID",
+      "IT_IT",
       "JA_JP",
       "KO_KR",
       "NB_NO",
       "NL_NL",
       "PL_PL",
+      "PT_BR",
       "PT_PT",
       "RO_RO",
       "RU_RU",
       "SV_SE",
       "TH_TH",
+      "TR_TR",
       "VI_VN",
       "ZH_CN",
+      "ZH_HK",
+      "ZH_TW",
     ]
 
 

data/lib/facebook_ads/ad_objects/live_video.rb

@@ -27,26 +27,26 @@ module FacebookAds
 
   class LiveVideo < AdObject
     BROADCAST_STATUS = [
-      "UNPUBLISHED",
       "LIVE",
       "LIVE_STOPPED",
       "PROCESSING",
-      "VOD",
-      "SCHEDULED_UNPUBLISHED",
-      "SCHEDULED_LIVE",
-      "SCHEDULED_EXPIRED",
       "SCHEDULED_CANCELED",
+      "SCHEDULED_EXPIRED",
+      "SCHEDULED_LIVE",
+      "SCHEDULED_UNPUBLISHED",
+      "UNPUBLISHED",
+      "VOD",
     ]
 
     PROJECTION = [
-      "EQUIRECTANGULAR",
       "CUBEMAP",
+      "EQUIRECTANGULAR",
       "HALF_EQUIRECTANGULAR",
     ]
 
     SOURCE = [
-      "target",
       "owner",
+      "target",
     ]
 
     SPATIAL_AUDIO_FORMAT = [
@@ -54,30 +54,30 @@ module FacebookAds
     ]
 
     STATUS = [
-      "UNPUBLISHED",
       "LIVE_NOW",
-      "SCHEDULED_UNPUBLISHED",
-      "SCHEDULED_LIVE",
       "SCHEDULED_CANCELED",
+      "SCHEDULED_LIVE",
+      "SCHEDULED_UNPUBLISHED",
+      "UNPUBLISHED",
     ]
 
     STEREOSCOPIC_MODE = [
-      "MONO",
       "LEFT_RIGHT",
+      "MONO",
       "TOP_BOTTOM",
     ]
 
     STREAM_TYPE = [
-      "REGULAR",
       "AMBIENT",
+      "REGULAR",
     ]
 
     LIVE_COMMENT_MODERATION_SETTING = [
-      "FOLLOWER",
-      "SLOW",
       "DISCUSSION",
-      "RESTRICTED",
+      "FOLLOWER",
       "PROTECTED_MODE",
+      "RESTRICTED",
+      "SLOW",
       "SUPPORTER",
     ]
 

data/lib/facebook_ads/ad_objects/measurement_report.rb

@@ -27,12 +27,12 @@ module FacebookAds
 
   class MeasurementReport < AdObject
     REPORT_TYPE = [
-      "multi_channel_report",
-      "video_metrics_report",
       "fruit_rollup_report",
-      "third_party_mta_report",
-      "partner_lift_study_report",
       "mmm_report",
+      "multi_channel_report",
+      "partner_lift_study_report",
+      "third_party_mta_report",
+      "video_metrics_report",
     ]
 
 

data/lib/facebook_ads/ad_objects/measurement_upload_event.rb

@@ -26,19 +26,53 @@ module FacebookAds
   # pull request for this class.
 
   class MeasurementUploadEvent < AdObject
+    AGGREGATION_LEVEL = [
+      "DAILY",
+      "NONE",
+      "WEEKLY",
+    ]
+
+    EVENT_STATUS = [
+      "CANCELCOMPLETED",
+      "CANCELED",
+      "COMPLETED",
+      "FAILED",
+      "STARTED",
+      "UPLOADED",
+    ]
+
     GROUP = [
-      "SUNDAY",
       "MONDAY",
+      "SUNDAY",
+    ]
+
+    LOOKBACK_WINDOW = [
+      "DAYS30",
+      "DAYS45",
+      "DAYS60",
+      "DAYS90",
+    ]
+
+    MATCH_UNIVERSE = [
+      "FULL",
+      "PII",
+      "PIXEL",
     ]
 
     VERSION = [
-      "WEEKLY",
       "EVALUATION",
+      "WEEKLY",
     ]
 
 
+    field :aggregation_level, 'string'
+    field :conversion_end_date, 'string'
+    field :conversion_start_date, 'string'
+    field :event_status, 'string'
     field :group, 'string'
     field :id, 'string'
+    field :lookback_window, 'string'
+    field :match_universe, 'string'
     field :partner, 'Business'
     field :upload_end_time, 'datetime'
     field :upload_start_time, 'datetime'

data/lib/facebook_ads/ad_objects/media_fingerprint.rb

@@ -27,17 +27,17 @@ module FacebookAds
 
   class MediaFingerprint < AdObject
     FINGERPRINT_CONTENT_TYPE = [
-      "SONGTRACK",
+      "AM_SONGTRACK",
       "EPISODE",
-      "OTHER",
       "MOVIE",
-      "AM_SONGTRACK",
+      "OTHER",
+      "SONGTRACK",
     ]
 
     FINGERPRINT_VALIDITY = [
-      "VALID",
-      "EXPIRING",
       "EXPIRED",
+      "EXPIRING",
+      "VALID",
     ]
 
 

data/lib/facebook_ads/ad_objects/native_offer.rb

@@ -27,13 +27,13 @@ module FacebookAds
 
   class NativeOffer < AdObject
     UNIQUE_CODES_FILE_CODE_TYPE = [
-      "discount_codes",
       "barcodes",
-      "online_discount_codes",
-      "instore_discount_codes",
-      "instore_barcodes",
       "discount_and_barcodes",
       "discount_and_discount",
+      "discount_codes",
+      "instore_barcodes",
+      "instore_discount_codes",
+      "online_discount_codes",
     ]
 
     BARCODE_TYPE = [
@@ -53,9 +53,9 @@ module FacebookAds
     ]
 
     LOCATION_TYPE = [
-      "online",
-      "offline",
       "both",
+      "offline",
+      "online",
     ]
 
 

data/lib/facebook_ads/ad_objects/offline_conversion_data_set.rb

@@ -28,21 +28,21 @@ module FacebookAds
   class OfflineConversionDataSet < AdObject
     PERMITTED_ROLES = [
       "ADMIN",
-      "UPLOADER",
       "ADVERTISER",
+      "UPLOADER",
     ]
 
     RELATIONSHIP_TYPE = [
       "AD_MANAGER",
-      "AUDIENCE_MANAGER",
       "AGENCY",
+      "AUDIENCE_MANAGER",
       "OTHER",
     ]
 
     ROLE = [
       "ADMIN",
-      "UPLOADER",
       "ADVERTISER",
+      "UPLOADER",
     ]
 
 
@@ -72,7 +72,7 @@ module FacebookAds
         api.has_param :business_id, 'string'
         api.has_param :start_time, 'datetime'
         api.has_param :end_time, 'datetime'
-        api.has_param :event_type, { enum: %w{dataset_assign_to_adacct dataset_autotrack_on_adacct dataset_disable_autotrack_on_adacct dataset_unassign_from_adacct add_dataset_to_business add_user_to_dataset remove_user_from_dataset update_user_role_on_dataset create_custom_conversion update_custom_conversion create_custom_audience share_custom_audience unshare_custom_audience }}
+        api.has_param :event_type, { enum: %w{add_dataset_to_business add_user_to_dataset create_custom_audience create_custom_conversion dataset_assign_to_adacct dataset_autotrack_on_adacct dataset_disable_autotrack_on_adacct dataset_unassign_from_adacct remove_user_from_dataset share_custom_audience unshare_custom_audience update_custom_conversion update_user_role_on_dataset }}
       end
     end
 
@@ -138,7 +138,7 @@ module FacebookAds
         api.has_param :start, 'int'
         api.has_param :end, 'int'
         api.has_param :skip_empty_values, 'bool'
-        api.has_param :aggr_time, { enum: %w{upload_time event_time }}
+        api.has_param :aggr_time, { enum: %w{event_time upload_time }}
         api.has_param :user_timezone_id, 'int'
         api.has_param :granularity, { enum: %w{daily hourly six_hourly }}
       end
@@ -149,7 +149,7 @@ module FacebookAds
         api.has_param :upload_tag, 'string'
         api.has_param :start_time, 'datetime'
         api.has_param :end_time, 'datetime'
-        api.has_param :sort_by, { enum: %w{CREATION_TIME FIRST_UPLOAD_TIME LAST_UPLOAD_TIME API_CALLS EVENT_TIME_MIN EVENT_TIME_MAX IS_EXCLUDED_FOR_LIFT }}
+        api.has_param :sort_by, { enum: %w{API_CALLS CREATION_TIME EVENT_TIME_MAX EVENT_TIME_MIN FIRST_UPLOAD_TIME IS_EXCLUDED_FOR_LIFT LAST_UPLOAD_TIME }}
         api.has_param :order, { enum: %w{ASCENDING DESCENDING }}
       end
       edge.post do |api|

data/lib/facebook_ads/ad_objects/page.rb

@@ -27,9 +27,9 @@ module FacebookAds
 
   class Page < AdObject
     ATTIRE = [
-      "Unspecified",
       "Casual",
       "Dressy",
+      "Unspecified",
     ]
 
     FOOD_STYLES = [
@@ -93,61 +93,61 @@ module FacebookAds
     ]
 
     SETTING = [
-      "POST_AS_SELF",
       "EMAIL_NOTIF",
       "MOBILE_NOTIF",
+      "POST_AS_SELF",
     ]
 
     AUDIENCE = [
-      "GROUPER",
-      "NCPP",
+      "AUTO_LOOKALIKE",
+      "AUTO_PAGE_LOOKALIKE",
+      "AUTO_TARGETING",
+      "CREATE_NEW",
       "CUSTOM_AUDIENCE",
-      "LOOKALIKE",
+      "DISTRICT",
+      "EVENT_CUSTOM_AUDIENCES",
+      "EVENT_ENGAGEMENT",
       "FANS",
-      "LOCAL",
+      "GROUPER",
       "IG_PROMOTED_POST_AUTO",
+      "LOCAL",
+      "LOOKALIKE",
+      "MULT_CUSTOM_AUDIENCES",
+      "NCPP",
       "SAVED_AUDIENCE",
-      "EVENT_ENGAGEMENT",
-      "DISTRICT",
       "SMART_AUDIENCE",
-      "CREATE_NEW",
-      "AUTO_LOOKALIKE",
-      "MULT_CUSTOM_AUDIENCES",
-      "EVENT_CUSTOM_AUDIENCES",
-      "AUTO_PAGE_LOOKALIKE",
-      "AUTO_TARGETING",
     ]
 
     PERMITTED_TASKS = [
-      "MANAGE",
+      "ADVERTISE",
+      "ANALYZE",
       "CREATE_CONTENT",
+      "MANAGE",
+      "MANAGE_JOBS",
       "MODERATE",
       "MODERATE_COMMUNITY",
-      "MANAGE_JOBS",
-      "ADVERTISE",
-      "ANALYZE",
     ]
 
     TASKS = [
-      "MANAGE",
+      "ADVERTISE",
+      "ANALYZE",
       "CREATE_CONTENT",
+      "MANAGE",
+      "MANAGE_JOBS",
       "MODERATE",
       "MODERATE_COMMUNITY",
-      "MANAGE_JOBS",
-      "ADVERTISE",
-      "ANALYZE",
     ]
 
     MESSAGING_TYPE = [
+      "MESSAGE_TAG",
       "RESPONSE",
       "UPDATE",
-      "MESSAGE_TAG",
     ]
 
     NOTIFICATION_TYPE = [
+      "NO_PUSH",
       "REGULAR",
       "SILENT_PUSH",
-      "NO_PUSH",
     ]
 
     PUBLISH_STATUS = [
@@ -157,13 +157,13 @@ module FacebookAds
 
     SENDER_ACTION = [
       "MARK_SEEN",
-      "TYPING_ON",
       "TYPING_OFF",
+      "TYPING_ON",
     ]
 
     TYPE = [
-      "STANDARD",
       "REF",
+      "STANDARD",
     ]
 
     MODEL = [
@@ -193,78 +193,78 @@ module FacebookAds
     ]
 
     FILTERING = [
+      "ema",
       "groups",
       "groups_social",
-      "ema",
     ]
 
     SUBSCRIBED_FIELDS = [
-      "feed",
-      "mention",
-      "name",
-      "picture",
+      "affiliation",
+      "attire",
+      "awards",
+      "bio",
+      "birthday",
+      "branded_camera",
       "category",
-      "description",
+      "checkins",
+      "company_overview",
       "conversations",
-      "branded_camera",
+      "culinary_team",
+      "current_location",
+      "description",
+      "email",
       "feature_access_list",
-      "standby",
+      "feed",
+      "founded",
+      "general_info",
+      "general_manager",
+      "hometown",
+      "hours",
+      "leadgen",
+      "leadgen_fat",
+      "live_videos",
+      "location",
+      "members",
+      "mention",
+      "merchant_review",
+      "message_deliveries",
+      "message_echoes",
+      "message_reads",
       "messages",
       "messaging_account_linking",
+      "messaging_appointments",
       "messaging_checkout_updates",
-      "message_echoes",
-      "message_deliveries",
       "messaging_game_plays",
+      "messaging_handovers",
       "messaging_optins",
       "messaging_optouts",
+      "messaging_page_feedback",
       "messaging_payments",
+      "messaging_policy_enforcement",
       "messaging_postbacks",
       "messaging_pre_checkouts",
-      "message_reads",
       "messaging_referrals",
-      "messaging_handovers",
-      "messaging_policy_enforcement",
-      "messaging_page_feedback",
-      "messaging_appointments",
-      "founded",
-      "company_overview",
       "mission",
-      "products",
-      "general_info",
-      "leadgen",
-      "leadgen_fat",
-      "location",
-      "hours",
-      "parking",
-      "public_transit",
+      "name",
       "page_about_story",
-      "phone",
-      "email",
-      "website",
-      "ratings",
-      "attire",
+      "page_change_proposal",
+      "page_upcoming_change",
+      "parking",
       "payment_options",
-      "culinary_team",
-      "general_manager",
-      "price_range",
-      "awards",
-      "hometown",
-      "current_location",
-      "bio",
-      "affiliation",
-      "birthday",
       "personal_info",
       "personal_interests",
-      "publisher_subscriptions",
-      "members",
-      "checkins",
-      "page_upcoming_change",
-      "page_change_proposal",
-      "merchant_review",
+      "phone",
+      "picture",
+      "price_range",
       "product_review",
-      "videos",
-      "live_videos",
+      "products",
+      "public_transit",
+      "publisher_subscriptions",
+      "ratings",
       "registration",
+      "standby",
+      "videos",
+      "website",
     ]
 
     DOMAIN_ACTION_TYPE = [
@@ -277,6 +277,19 @@ module FacebookAds
       "REMOVE",
     ]
 
+    SETTING_TYPE = [
+      "ACCOUNT_LINKING",
+      "CALL_TO_ACTIONS",
+      "DOMAIN_WHITELISTING",
+      "GREETING",
+      "PAYMENT",
+    ]
+
+    THREAD_STATE = [
+      "EXISTING_THREAD",
+      "NEW_THREAD",
+    ]
+
 
     field :about, 'string'
     field :access_token, 'string'
@@ -504,6 +517,9 @@ module FacebookAds
     end
 
     has_edge :assigned_users do |edge|
+      edge.delete do |api|
+        api.has_param :user, 'int'
+      end
       edge.get 'AssignedUser' do |api|
         api.has_param :business, 'string'
       end
@@ -650,9 +666,9 @@ module FacebookAds
       edge.post do |api|
         api.has_param :reference_asset_id, 'string'
         api.has_param :matched_asset_id, 'string'
-        api.has_param :match_content_type, { enum: %w{VIDEO_AND_AUDIO VIDEO_ONLY AUDIO_ONLY }}
-        api.has_param :action, { enum: %w{MANUAL_REVIEW MONITOR BLOCK CLAIM_AD_EARNINGS REQUEST_TAKEDOWN }}
-        api.has_param :action_reason, { enum: %w{UNAUTHORIZED_COMMERCIAL_USE RESTRICTED_CONTENT OBJECTIONABLE_CONTENT ARTIST_OBJECTION PRERELEASE_CONTENT PRODUCT_PARAMETERS PREMIUM_MUSIC_VIDEO }}
+        api.has_param :match_content_type, { enum: %w{AUDIO_ONLY VIDEO_AND_AUDIO VIDEO_ONLY }}
+        api.has_param :action, { enum: %w{BLOCK CLAIM_AD_EARNINGS MANUAL_REVIEW MONITOR REQUEST_TAKEDOWN }}
+        api.has_param :action_reason, { enum: %w{ARTIST_OBJECTION OBJECTIONABLE_CONTENT PREMIUM_MUSIC_VIDEO PRERELEASE_CONTENT PRODUCT_PARAMETERS RESTRICTED_CONTENT UNAUTHORIZED_COMMERCIAL_USE }}
         api.has_param :countries, 'object'
       end
     end
@@ -815,7 +831,7 @@ module FacebookAds
         api.has_param :composer_session_events_log, 'string'
         api.has_param :composer_source_surface, 'string'
         api.has_param :composer_type, 'string'
-        api.has_param :fun_fact_prompt_id, 'string'
+        api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
         api.has_param :is_group_linking_post, 'bool'
         api.has_param :has_nickname, 'bool'
@@ -824,7 +840,7 @@ module FacebookAds
         api.has_param :is_boost_intended, 'bool'
         api.has_param :location_source_id, 'string'
         api.has_param :message, 'string'
-        api.has_param :offer_like_post_id, 'string'
+        api.has_param :offer_like_post_id, 'int'
         api.has_param :page_recommendation, 'string'
         api.has_param :place_list, 'string'
         api.has_param :publish_event_id, 'int'
@@ -1126,7 +1142,7 @@ module FacebookAds
 
     has_edge :messenger_profile do |edge|
       edge.delete do |api|
-        api.has_param :fields, { list: { enum: %w{GET_STARTED PERSISTENT_MENU TARGET_AUDIENCE WHITELISTED_DOMAINS GREETING ACCOUNT_LINKING_URL PAYMENT_SETTINGS HOME_URL }} }
+        api.has_param :fields, { list: { enum: %w{ACCOUNT_LINKING_URL GET_STARTED GREETING HOME_URL PAYMENT_SETTINGS PERSISTENT_MENU TARGET_AUDIENCE WHITELISTED_DOMAINS }} }
       end
       edge.get 'MessengerProfile'
       edge.post 'Page' do |api|
@@ -1508,13 +1524,13 @@ module FacebookAds
 
     has_edge :thread_settings do |edge|
       edge.delete do |api|
-        api.has_param :setting_type, { enum: %w{ACCOUNT_LINKING CALL_TO_ACTIONS GREETING DOMAIN_WHITELISTING PAYMENT }}
-        api.has_param :thread_state, { enum: %w{NEW_THREAD EXISTING_THREAD }}
+        api.has_param :setting_type, { enum: -> { Page::SETTING_TYPE }}
+        api.has_param :thread_state, { enum: -> { Page::THREAD_STATE }}
       end
       edge.get 'ThreadSetting'
       edge.post 'Page' do |api|
-        api.has_param :setting_type, { enum: %w{ACCOUNT_LINKING CALL_TO_ACTIONS GREETING DOMAIN_WHITELISTING PAYMENT }}
-        api.has_param :thread_state, { enum: %w{NEW_THREAD EXISTING_THREAD }}
+        api.has_param :setting_type, { enum: -> { Page::SETTING_TYPE }}
+        api.has_param :thread_state, { enum: -> { Page::THREAD_STATE }}
         api.has_param :call_to_actions, { list: 'object' }
         api.has_param :greeting, 'object'
         api.has_param :account_linking_url, 'string'
@@ -1635,7 +1651,7 @@ module FacebookAds
         api.has_param :composer_source_surface, 'string'
         api.has_param :composer_type, 'string'
         api.has_param :formatting, { enum: -> { AdVideo::FORMATTING }}
-        api.has_param :fun_fact_prompt_id, 'string'
+        api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
         api.has_param :is_group_linking_post, 'bool'
         api.has_param :has_nickname, 'bool'
@@ -1644,7 +1660,7 @@ module FacebookAds
         api.has_param :is_boost_intended, 'bool'
         api.has_param :location_source_id, 'string'
         api.has_param :description, 'string'
-        api.has_param :offer_like_post_id, 'string'
+        api.has_param :offer_like_post_id, 'int'
         api.has_param :publish_event_id, 'int'
         api.has_param :react_mode_metadata, 'string'
         api.has_param :sales_promo_id, 'int'