facebookbusiness 0.9.0.1 → 0.11.0.0

data/lib/facebook_ads/ad_objects/{ad_account_roas.rb → product_catalog_diagnostic_group.rb}

@@ -25,37 +25,62 @@ 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 AdAccountRoas < AdObject
+  class ProductCatalogDiagnosticGroup < AdObject
+    AFFECTED_CHANNELS = [
+      "business_inbox_in_messenger",
+      "shops",
+      "test_capability",
+      "universal_checkout",
+      "us_marketplace",
+    ]
 
-    field :adgroup_id, 'string'
-    field :arpu_180d, 'double'
-    field :arpu_1d, 'double'
-    field :arpu_30d, 'double'
-    field :arpu_365d, 'double'
-    field :arpu_3d, 'double'
-    field :arpu_7d, 'double'
-    field :arpu_90d, 'double'
-    field :campaign_group_id, 'string'
-    field :campaign_id, 'string'
-    field :date_start, 'string'
-    field :date_stop, 'string'
-    field :installs, 'int'
-    field :revenue, 'double'
-    field :revenue_180d, 'double'
-    field :revenue_1d, 'double'
-    field :revenue_30d, 'double'
-    field :revenue_365d, 'double'
-    field :revenue_3d, 'double'
-    field :revenue_7d, 'double'
-    field :revenue_90d, 'double'
-    field :spend, 'double'
-    field :yield_180d, 'double'
-    field :yield_1d, 'double'
-    field :yield_30d, 'double'
-    field :yield_365d, 'double'
-    field :yield_3d, 'double'
-    field :yield_7d, 'double'
-    field :yield_90d, 'double'
+    AFFECTED_FEATURES = [
+      "augmented_reality",
+      "checkout",
+    ]
+
+    SEVERITY = [
+      "MUST_FIX",
+      "OPPORTUNITY",
+    ]
+
+    TYPE = [
+      "ATTRIBUTES_INVALID",
+      "ATTRIBUTES_MISSING",
+      "CATEGORY",
+      "CHECKOUT",
+      "IMAGE_QUALITY",
+      "LOW_QUALITY_TITLE_AND_DESCRIPTION",
+      "POLICY_VIOLATION",
+      "SHOPS_VISIBILITY_ISSUES",
+    ]
+
+    SEVERITIES = [
+      "MUST_FIX",
+      "OPPORTUNITY",
+    ]
+
+    TYPES = [
+      "ATTRIBUTES_INVALID",
+      "ATTRIBUTES_MISSING",
+      "CATEGORY",
+      "CHECKOUT",
+      "IMAGE_QUALITY",
+      "LOW_QUALITY_TITLE_AND_DESCRIPTION",
+      "POLICY_VIOLATION",
+      "SHOPS_VISIBILITY_ISSUES",
+    ]
+
+
+    field :affected_channels, { list: { enum: -> { AFFECTED_CHANNELS }} }
+    field :affected_features, { list: { enum: -> { AFFECTED_FEATURES }} }
+    field :diagnostics, { list: 'object' }
+    field :error_code, 'int'
+    field :number_of_affected_items, 'int'
+    field :severity, { enum: -> { SEVERITY }}
+    field :subtitle, 'string'
+    field :title, 'string'
+    field :type, { enum: -> { TYPE }}
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/product_feed.rb

@@ -53,6 +53,7 @@ module FacebookAds
 
     FEED_TYPE = [
       "AUTO",
+      "AUTOMOTIVE_MODEL",
       "DESTINATION",
       "FLIGHT",
       "HOME_LISTING",
@@ -126,7 +127,11 @@ module FacebookAds
     field :feed_type, { enum: -> { FEED_TYPE }}
     field :override_value, 'string'
     field :rules, { list: 'string' }
-    field :whitelisted_properties, { list: 'string' }
+    field :selected_override_fields, { list: 'string' }
+
+    has_edge :auto_markets do |edge|
+      edge.get
+    end
 
     has_edge :automotive_models do |edge|
       edge.get 'AutomotiveModel' do |api|
@@ -135,6 +140,10 @@ module FacebookAds
       end
     end
 
+    has_edge :autos do |edge|
+      edge.get
+    end
+
     has_edge :destinations do |edge|
       edge.get 'Destination' do |api|
         api.has_param :bulk_pagination, 'bool'
@@ -163,6 +172,13 @@ module FacebookAds
       end
     end
 
+    has_edge :media_titles do |edge|
+      edge.get do |api|
+        api.has_param :bulk_pagination, 'bool'
+        api.has_param :filter, 'object'
+      end
+    end
+
     has_edge :products do |edge|
       edge.get 'ProductItem' do |api|
         api.has_param :bulk_pagination, 'bool'

data/lib/facebook_ads/ad_objects/product_feed_schedule.rb

@@ -54,6 +54,8 @@ module FacebookAds
     field :timezone, 'string'
     field :url, 'string'
     field :username, 'string'
+    has_no_post
+    has_no_delete
 
   end
 end

data/lib/facebook_ads/ad_objects/product_group.rb

@@ -34,20 +34,20 @@ module FacebookAds
 
     has_edge :products do |edge|
       edge.get 'ProductItem'
-      edge.post 'ProductItem' do |api|
+      edge.post do |api|
         api.has_param :additional_image_urls, { list: 'string' }
         api.has_param :additional_variant_attributes, 'hash'
         api.has_param :android_app_name, 'string'
         api.has_param :android_class, 'string'
         api.has_param :android_package, 'string'
         api.has_param :android_url, 'string'
-        api.has_param :availability, { enum: -> { ProductItem::AVAILABILITY }}
+        api.has_param :availability, { enum: %w{available for order discontinued in stock out of stock pending preorder }}
         api.has_param :brand, 'string'
         api.has_param :category, 'string'
         api.has_param :checkout_url, 'string'
         api.has_param :color, 'string'
-        api.has_param :commerce_tax_category, { enum: -> { ProductItem::COMMERCE_TAX_CATEGORY }}
-        api.has_param :condition, { enum: -> { ProductItem::CONDITION }}
+        api.has_param :commerce_tax_category, { enum: %w{FB_ANIMAL FB_ANIMAL_SUPP FB_APRL FB_APRL_ACCESSORIES FB_APRL_ATHL_UNIF FB_APRL_CASES FB_APRL_CLOTHING FB_APRL_COSTUME FB_APRL_CSTM FB_APRL_FORMAL FB_APRL_HANDBAG FB_APRL_JEWELRY FB_APRL_SHOE FB_APRL_SHOE_ACC FB_APRL_SWIM FB_APRL_SWIM_CHIL FB_APRL_SWIM_CVR FB_ARTS FB_ARTS_HOBBY FB_ARTS_PARTY FB_ARTS_PARTY_GIFT_CARD FB_ARTS_TICKET FB_BABY FB_BABY_BATH FB_BABY_BLANKET FB_BABY_DIAPER FB_BABY_GIFT_SET FB_BABY_HEALTH FB_BABY_NURSING FB_BABY_POTTY_TRN FB_BABY_SAFE FB_BABY_TOYS FB_BABY_TRANSPORT FB_BABY_TRANSPORT_ACC FB_BAGS FB_BAGS_BKPK FB_BAGS_BOXES FB_BAGS_BRFCS FB_BAGS_CSMT_BAG FB_BAGS_DFFL FB_BAGS_DIPR FB_BAGS_FNNY FB_BAGS_GRMT FB_BAGS_LUGG FB_BAGS_LUG_ACC FB_BAGS_MSGR FB_BAGS_TOTE FB_BAGS_TRN_CAS FB_BLDG FB_BLDG_ACC FB_BLDG_CNSMB FB_BLDG_FENCE FB_BLDG_FUEL_TNK FB_BLDG_HT_VNT FB_BLDG_LOCK FB_BLDG_MATRL FB_BLDG_PLMB FB_BLDG_PUMP FB_BLDG_PWRS FB_BLDG_STR_TANK FB_BLDG_S_ENG FB_BLDG_TL_ACC FB_BLDG_TOOL FB_BUSIND FB_BUSIND_ADVERTISING FB_BUSIND_AGRICULTURE FB_BUSIND_AUTOMATION FB_BUSIND_HEAVY_MACH FB_BUSIND_LAB FB_BUSIND_MEDICAL FB_BUSIND_RETAIL FB_BUSIND_SANITARY_CT FB_BUSIND_SIGN FB_BUSIND_STORAGE FB_BUSIND_STORAGE_ACC FB_BUSIND_WORK_GEAR FB_CAMERA_ACC FB_CAMERA_CAMERA FB_CAMERA_OPTIC FB_CAMERA_OPTICS FB_CAMERA_PHOTO FB_ELEC FB_ELEC_ACC FB_ELEC_ARCDADE FB_ELEC_AUDIO FB_ELEC_CIRCUIT FB_ELEC_COMM FB_ELEC_COMPUTER FB_ELEC_GPS_ACC FB_ELEC_GPS_NAV FB_ELEC_GPS_TRK FB_ELEC_MARINE FB_ELEC_NETWORK FB_ELEC_PART FB_ELEC_PRINT FB_ELEC_RADAR FB_ELEC_SPEED_RDR FB_ELEC_TOLL FB_ELEC_VIDEO FB_ELEC_VID_GM_ACC FB_ELEC_VID_GM_CNSL FB_FOOD FB_FURN FB_FURN_BABY FB_FURN_BENCH FB_FURN_CART FB_FURN_CHAIR FB_FURN_CHAIR_ACC FB_FURN_DIVIDE FB_FURN_DIVIDE_ACC FB_FURN_ENT_CTR FB_FURN_FUTN FB_FURN_FUTN_PAD FB_FURN_OFFICE FB_FURN_OFFICE_ACC FB_FURN_OTTO FB_FURN_OUTDOOR FB_FURN_OUTDOOR_ACC FB_FURN_SETS FB_FURN_SHELVE_ACC FB_FURN_SHLF FB_FURN_SOFA FB_FURN_SOFA_ACC FB_FURN_STORAGE FB_FURN_TABL FB_FURN_TABL_ACC FB_GENERIC_TAXABLE FB_HLTH FB_HLTH_HLTH FB_HLTH_JWL_CR FB_HLTH_LILP_BLM FB_HLTH_LTN_SPF FB_HLTH_PRSL_CR FB_HLTH_SKN_CR FB_HMGN FB_HMGN_BATH FB_HMGN_DCOR FB_HMGN_EMGY FB_HMGN_FPLC FB_HMGN_FPLC_ACC FB_HMGN_GS_SFT FB_HMGN_HS_ACC FB_HMGN_HS_APP FB_HMGN_HS_SPL FB_HMGN_KTCN FB_HMGN_LAWN FB_HMGN_LGHT FB_HMGN_LINN FB_HMGN_LT_ACC FB_HMGN_OTDR FB_HMGN_POOL FB_HMGN_SCTY FB_HMGN_SMK_ACC FB_HMGN_UMBR FB_HMGN_UMBR_ACC FB_MDIA FB_MDIA_BOOK FB_MDIA_DVDS FB_MDIA_MAG FB_MDIA_MANL FB_MDIA_MUSC FB_MDIA_PRJ_PLN FB_MDIA_SHT_MUS FB_OFFC FB_OFFC_BKAC FB_OFFC_CRTS FB_OFFC_DSKP FB_OFFC_EQIP FB_OFFC_FLNG FB_OFFC_GNRL FB_OFFC_INSTM FB_OFFC_LP_DSK FB_OFFC_MATS FB_OFFC_NM_PLT FB_OFFC_PPR_HNDL FB_OFFC_PRSNT_SPL FB_OFFC_SEALR FB_OFFC_SHIP_SPL FB_RLGN FB_RLGN_CMNY FB_RLGN_ITEM FB_RLGN_WEDD FB_SFTWR FB_SFWR_CMPTR FB_SFWR_DGTL_GD FB_SFWR_GAME FB_SHIPPING FB_SPOR FB_SPORT_ATHL FB_SPORT_ATHL_CLTH FB_SPORT_ATHL_SHOE FB_SPORT_ATHL_SPRT FB_SPORT_EXRCS FB_SPORT_INDR_GM FB_SPORT_OTDR_GM FB_TOYS FB_TOYS_EQIP FB_TOYS_GAME FB_TOYS_PZZL FB_TOYS_TMRS FB_TOYS_TOYS FB_VEHI FB_VEHI_PART }}
+        api.has_param :condition, { enum: %w{cpo new open_box_new refurbished used used_fair used_good used_like_new }}
         api.has_param :currency, 'string'
         api.has_param :custom_data, 'hash'
         api.has_param :custom_label_0, 'string'
@@ -58,7 +58,7 @@ module FacebookAds
         api.has_param :description, 'string'
         api.has_param :expiration_date, 'string'
         api.has_param :fb_product_category, 'string'
-        api.has_param :gender, { enum: -> { ProductItem::GENDER }}
+        api.has_param :gender, { enum: %w{female male unisex }}
         api.has_param :gtin, 'string'
         api.has_param :image_url, 'string'
         api.has_param :inventory, 'int'
@@ -73,6 +73,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: %w{default marked not_marked }}
         api.has_param :material, 'string'
         api.has_param :mobile_link, 'string'
         api.has_param :name, 'string'
@@ -83,6 +84,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 :return_policy_days, 'int'
         api.has_param :sale_price, 'int'
@@ -92,7 +94,7 @@ module FacebookAds
         api.has_param :size, 'string'
         api.has_param :start_date, 'string'
         api.has_param :url, 'string'
-        api.has_param :visibility, { enum: -> { ProductItem::VISIBILITY }}
+        api.has_param :visibility, { enum: %w{published staging }}
         api.has_param :windows_phone_app_id, 'string'
         api.has_param :windows_phone_app_name, 'string'
         api.has_param :windows_phone_url, 'string'

data/lib/facebook_ads/ad_objects/product_item.rb

@@ -62,6 +62,15 @@ module FacebookAds
       "unisex",
     ]
 
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
     REVIEW_STATUS = [
       "",
       "approved",
@@ -92,6 +101,7 @@ module FacebookAds
       "FB_APRL_CLOTHING",
       "FB_APRL_COSTUME",
       "FB_APRL_CSTM",
+      "FB_APRL_FORMAL",
       "FB_APRL_HANDBAG",
       "FB_APRL_JEWELRY",
       "FB_APRL_SHOE",
@@ -287,12 +297,19 @@ module FacebookAds
       "FB_VEHI_PART",
     ]
 
+    MARKED_FOR_PRODUCT_LAUNCH = [
+      "default",
+      "marked",
+      "not_marked",
+    ]
+
 
     field :additional_image_cdn_urls, { list: 'hash' }
     field :additional_image_urls, { list: 'string' }
     field :additional_variant_attributes, 'hash'
     field :age_group, { enum: -> { AGE_GROUP }}
     field :applinks, 'CatalogItemAppLinks'
+    field :ar_data, 'ProductItemArData'
     field :availability, { enum: -> { AVAILABILITY }}
     field :brand, 'string'
     field :capability_to_review_status, 'hash'
@@ -315,20 +332,24 @@ module FacebookAds
     field :gtin, 'string'
     field :id, 'string'
     field :image_cdn_urls, 'hash'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
     field :image_url, 'string'
     field :images, { list: 'string' }
     field :inventory, 'int'
     field :manufacturer_part_number, 'string'
+    field :marked_for_product_launch, 'string'
     field :material, 'string'
     field :mobile_link, 'string'
     field :name, 'string'
     field :ordering_index, 'int'
+    field :parent_product_id, 'string'
     field :pattern, 'string'
     field :price, 'string'
     field :product_catalog, 'ProductCatalog'
     field :product_feed, 'ProductFeed'
     field :product_group, 'ProductGroup'
     field :product_type, 'string'
+    field :quantity_to_sell_on_facebook, 'int'
     field :retailer_id, 'string'
     field :retailer_product_group_id, 'string'
     field :review_rejection_reasons, { list: 'string' }
@@ -343,7 +364,6 @@ module FacebookAds
     field :start_date, 'string'
     field :url, 'string'
     field :visibility, { enum: -> { VISIBILITY }}
-    field :additional_image_files, { list: 'file' }
     field :additional_uploaded_image_ids, { list: 'string' }
     field :android_app_name, 'string'
     field :android_class, 'string'
@@ -369,6 +389,10 @@ module FacebookAds
     field :windows_phone_app_name, 'string'
     field :windows_phone_url, 'string'
 
+    has_edge :channels_to_integrity_status do |edge|
+      edge.get 'CatalogItemChannelsToIntegrityStatus'
+    end
+
     has_edge :product_sets do |edge|
       edge.get 'ProductSet'
     end

data/lib/facebook_ads/ad_objects/{user_payment_methods_info.rb → product_item_ar_data.rb}

@@ -25,15 +25,31 @@ 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 UserPaymentMethodsInfo < AdObject
+  class ProductItemArData < AdObject
+    SURFACES = [
+      "B2C_MARKETPLACE",
+      "C2C_MARKETPLACE",
+      "DA",
+      "DAILY_DEALS",
+      "DAILY_DEALS_LEGACY",
+      "IG_PRODUCT_TAGGING",
+      "MARKETPLACE",
+      "MARKETPLACE_ADS_DEPRECATED",
+      "MARKETPLACE_SHOPS",
+      "OFFLINE_CONVERSIONS",
+      "SHOPS",
+      "UNIVERSAL_CHECKOUT",
+      "WHATSAPP",
+    ]
 
-    field :account_id, 'string'
-    field :available_card_types, { list: 'string' }
-    field :available_payment_methods, { list: 'string' }
-    field :available_payment_methods_details, { list: 'object' }
-    field :country, 'string'
-    field :currency, 'string'
-    field :existing_payment_methods, { list: 'object' }
+
+    field :container_effect, 'string'
+    field :effect_icon, 'string'
+    field :effect_parameters, 'object'
+    field :picker_icon, 'string'
+    field :product_ar_link, 'object'
+    field :state, 'string'
+    field :surfaces, { list: { enum: -> { SURFACES }} }
     has_no_id
     has_no_get
     has_no_post

data/lib/facebook_ads/ad_objects/product_set.rb

@@ -73,6 +73,13 @@ module FacebookAds
       end
     end
 
+    has_edge :media_titles do |edge|
+      edge.get do |api|
+        api.has_param :bulk_pagination, 'bool'
+        api.has_param :filter, 'object'
+      end
+    end
+
     has_edge :products do |edge|
       edge.get 'ProductItem' do |api|
         api.has_param :bulk_pagination, 'bool'

data/lib/facebook_ads/ad_objects/saved_audience.rb

@@ -29,10 +29,13 @@ module FacebookAds
 
     field :account, 'AdAccount'
     field :approximate_count, 'int'
+    field :approximate_count_64bit, 'int'
+    field :delete_time, 'int'
     field :description, 'string'
     field :extra_info, 'string'
     field :id, 'string'
     field :name, 'string'
+    field :operation_status, 'CustomAudienceStatus'
     field :permission_for_actions, 'AudiencePermissionForActions'
     field :run_status, 'string'
     field :sentence_lines, { list: 'string' }

data/lib/facebook_ads/ad_objects/server_side/user_data.rb

@@ -22,53 +22,157 @@ module FacebookAds
     # UserData is a set of identifiers Facebook can use for targeted attribution
     class UserData
 
+      # A list of email addresses, in lowercase.
+      # Example: ['joe@eg.com']
+      attr_accessor :emails
+
       # An email address, in lowercase.
       # Example: joe@eg.com
-      attr_accessor :email
+      def email
+        @emails ? @emails[0] : nil
+      end
+      def email=(email)
+        @emails = [email]
+      end
+
+      # A list of phone numbers. Include only digits with country code, area code, and number.
+      # Example: ['16505551212']
+      attr_accessor :phones
 
       # A phone number. Include only digits with country code, area code, and number.
       # Example: 16505551212
-      attr_accessor :phone
+      def phone
+        @phones ? @phones[0] : nil
+      end
+      def phone=(phone)
+        @phones = [phone]
+      end
+
+      # A list of genders, in lowercase.
+      # Example: ['f']
+      attr_accessor :genders
 
       # Gender, in lowercase. Either f or m.
-      attr_accessor :gender
+      def gender
+        @genders ? @genders[0] : nil
+      end
+      def gender=(gender)
+        @genders = [gender]
+      end
+
+      # A list of dates of birth given as year, month, and day.
+      # Format should be 'YYYYMMDD'
+      # Example: ['19971226'] for December 26, 1997.
+      attr_accessor :dates_of_birth
 
       # A date of birth given as year, month, and day.
       # Format should be 'YYYYMMDD'
       # Example: 19971226 for December 26, 1997.
-      attr_accessor :date_of_birth
+      def date_of_birth
+        @dates_of_birth ? @dates_of_birth[0] : nil
+      end
+      def date_of_birth=(date_of_birth)
+        @dates_of_birth = [date_of_birth]
+      end
+
+      # A list of last names in lowercase.
+      # Example: ['smith']
+      attr_accessor :last_names
 
       # A last name in lowercase.
       # Example: smith
-      attr_accessor :last_name
+      def last_name
+        @last_names ? @last_names[0] : nil
+      end
+      def last_name=(last_name)
+        @last_names = [last_name]
+      end
+
+      # A list of first names in lowercase.
+      # Example: ['joe']
+      attr_accessor :first_names
 
       # A first name in lowercase.
       # Example: joe
-      attr_accessor :first_name
+      def first_name
+        @first_names ? @first_names[0] : nil
+      end
+      def first_name=(first_name)
+        @first_names = [first_name]
+      end
+
+      # A list of cities in lower-case without spaces or punctuation.
+      # Example: ['menlopark']
+      attr_accessor :cities
 
       # A city in lower-case without spaces or punctuation.
       # Example: menlopark
-      attr_accessor :city
+      def city
+        @cities ? @cities[0] : nil
+      end
+      def city=(city)
+        @cities = [city]
+      end
+
+      # A list of two-letter country codes in lowercase.
+      # Example: ['us']
+      attr_accessor :country_codes
 
       # A two-letter country code in lowercase.
       # Example: us
-      attr_accessor :country_code
+      def country_code
+        @country_codes ? @country_codes[0] : nil
+      end
+      def country_code=(country_code)
+        @country_codes = [country_code]
+      end
+
+      # A list of two-letter state codes in lowercase.
+      # Example: ['ca']
+      attr_accessor :states
 
       # A two-letter state code in lowercase.
       # Example: ca
-      attr_accessor :state
+      def state
+        @states ? @states[0] : nil
+      end
+      def state=(state)
+        @states = [state]
+      end
+
+      # A list of five-digit zip codes for United States.
+      # For other locations, follow each country's standards.
+      # Example: ['94035'] (for United States)
+      attr_accessor :zip_codes
 
       # A five-digit zip code for United States.
       # For other locations, follow each country's standards.
       # Example: 94035 (for United States)
-      attr_accessor :zip_code
+      def zip_code
+        @zip_codes ? @zip_codes[0] : nil
+      end
+      def zip_code=(zip_code)
+        @zip_codes = [zip_code]
+      end
+
+      # A list of unique IDs from the advertiser, such as loyalty membership IDs, user IDs, and external cookie IDs.
+      # In the Offline Conversions API (https://www.facebook.com/business/help/104039186799009),
+      # this is known as extern_id. For more information, see Offline Conversions, Providing External IDs.
+      # If External ID is being sent via other channels, then it should be sent in the same format
+      # via the Conversions API.
+      attr_accessor :external_ids
 
       # Any unique ID from the advertiser, such as loyalty membership IDs, user IDs, and external cookie IDs.
       # In the Offline Conversions API (https://www.facebook.com/business/help/104039186799009),
       # this is known as extern_id. For more information, see Offline Conversions, Providing External IDs.
       # If External ID is being sent via other channels, then it should be sent in the same format
-      # via the server-side API.
-      attr_accessor :external_id
+      # via the Conversions API.
+      def external_id
+        @external_ids ? @external_ids[0] : nil
+      end
+      def external_id=(external_id)
+        @external_ids = [external_id]
+      end
 
       # The IP address of the browser corresponding to the event.
       attr_accessor :client_ip_address
@@ -78,13 +182,13 @@ module FacebookAds
 
       # The Facebook click ID value stored in the _fbc browser cookie under your domain.
       # See Managing fbc and fbp Parameters for how to get this value
-      # (https://developers.facebook.com/docs/marketing-api/facebook-pixel/server-side-api/parameters#fbc),
+      # (https://developers.facebook.com/docs/marketing-api/facebook-pixel/conversions-api/parameters#fbc),
       # or generate this value from a fbclid query parameter.
       attr_accessor :fbc
 
       # The Facebook browser ID value stored in the _fbp browser cookie under your domain.
       # See Managing fbc and fbp Parameters for how to get this value
-      # (https://developers.facebook.com/docs/marketing-api/facebook-pixel/server-side-api/parameters#fbc),
+      # (https://developers.facebook.com/docs/marketing-api/facebook-pixel/conversions-api/parameters#fbc),
       # or generate this value from a fbclid query parameter.
       attr_accessor :fbp
 
@@ -109,21 +213,32 @@ module FacebookAds
       # The date of birth month.
       attr_accessor :dobm
 
-      # THe date of birth year.
+      # The date of birth year.
       attr_accessor :doby
 
       #UserData is a set of identifiers Facebook can use for targeted attribution
       # @param [String] email
+      # @param [Array<String>] emails
       # @param [String] phone
+      # @param [Array<String>] phones
       # @param [String] gender
+      # @param [Array<String>] genders
       # @param [String] date_of_birth
+      # @param [Array<String>] dates_of_births
       # @param [String] last_name
+      # @param [Array<String>] last_names
       # @param [String] first_name
+      # @param [Array<String>] first_names
       # @param [String] city
+      # @param [Array<String>] cities
       # @param [String] state
+      # @param [Array<String>] states
       # @param [String] country_code
+      # @param [Array<String>] country_codes
       # @param [String] zip_code
+      # @param [Array<String>] zip_codes
       # @param [String] external_id
+      # @param [Array<String>] external_ids
       # @param [String] client_ip_address
       # @param [String] client_user_agent
       # @param [String] fbc
@@ -136,44 +251,91 @@ module FacebookAds
       # @param [String] dobd
       # @param [String] dobm
       # @param [String] doby
-      def initialize(email: nil, phone: nil, gender: nil, date_of_birth: nil,
-                     last_name: nil, first_name: nil, city: nil, state: nil,
-                     country_code: nil, zip_code: nil, external_id: nil, client_ip_address: nil,
+      def initialize(email: nil, emails: nil, phone: nil, phones: nil, gender: nil, genders: nil,
+                     date_of_birth: nil, dates_of_birth: nil, last_name: nil, last_names: nil,
+                     first_name: nil, first_names: nil, city: nil, cities: nil, state: nil, states: nil,
+                     country_code: nil, country_codes: nil, zip_code: nil, zip_codes: nil,
+                     external_id: nil, external_ids: nil, client_ip_address: nil,
                      client_user_agent: nil, fbc: nil, fbp: nil, subscription_id: nil, lead_id: nil,
                      f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil)
+        validate_constructor_values(emails, email, 'emails', 'email')
+        validate_constructor_values(phones, phone, 'phones', 'phone')
+        validate_constructor_values(genders, gender, 'genders', 'gender')
+        validate_constructor_values(dates_of_birth, date_of_birth, 'dates_of_birth', 'date_of_birth')
+        validate_constructor_values(first_names, first_name, 'first_names', 'first_name')
+        validate_constructor_values(last_names, last_name, 'last_names', 'last_name')
+        validate_constructor_values(cities, city, 'cities', 'city')
+        validate_constructor_values(country_codes, country_code, 'country_codes', 'country_code')
+        validate_constructor_values(states, state, 'states', 'state')
+        validate_constructor_values(zip_codes, zip_code, 'zip_codes', 'zip_code')
+        validate_constructor_values(external_ids, external_id, 'external_ids', 'external_id')
+
         unless email.nil?
           self.email = email
         end
+        unless emails.nil?
+          self.emails = emails
+        end
         unless phone.nil?
           self.phone = phone
         end
+        unless phones.nil?
+          self.phones = phones
+        end
         unless gender.nil?
           self.gender = gender
         end
+        unless genders.nil?
+          self.genders = genders
+        end
         unless date_of_birth.nil?
           self.date_of_birth = date_of_birth
         end
+        unless dates_of_birth.nil?
+          self.dates_of_birth = dates_of_birth
+        end
         unless last_name.nil?
           self.last_name = last_name
         end
+        unless last_names.nil?
+          self.last_names = last_names
+        end
         unless first_name.nil?
           self.first_name = first_name
         end
+        unless first_names.nil?
+          self.first_names = first_names
+        end
         unless city.nil?
           self.city = city
         end
+        unless cities.nil?
+          self.cities = cities
+        end
         unless state.nil?
           self.state = state
         end
+        unless states.nil?
+          self.states = states
+        end
         unless country_code.nil?
           self.country_code = country_code
         end
+        unless country_codes.nil?
+          self.country_codes = country_codes
+        end
         unless zip_code.nil?
           self.zip_code = zip_code
         end
+        unless zip_codes.nil?
+          self.zip_codes = zip_codes
+        end
         unless external_id.nil?
           self.external_id = external_id
         end
+        unless external_ids.nil?
+          self.external_ids = external_ids
+        end
         unless client_ip_address.nil?
           self.client_ip_address = client_ip_address
         end
@@ -220,48 +382,70 @@ module FacebookAds
         # convert string to symbol for hash key
         attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
 
-        if attributes.has_key?(:'email')
-          self.email = attributes[:'email']
+        if attributes.has_key?(:'emails')
+          self.emails = attributes[:'emails']
+        elsif attributes.has_key?(:'email')
+          self.emails = [attributes[:'email']]
         end
 
-        if attributes.has_key?(:'phone')
-          self.phone = attributes[:'phone']
+        if attributes.has_key?(:'phones')
+          self.phones = attributes[:'phones']
+        elsif attributes.has_key?(:'phone')
+          self.phones = [attributes[:'phone']]
         end
 
-        if attributes.has_key?(:'gender')
-          self.gender = attributes[:'gender']
+        if attributes.has_key?(:'genders')
+          self.genders = attributes[:'genders']
+        elsif attributes.has_key?(:'gender')
+          self.genders = [attributes[:'gender']]
         end
 
-        if attributes.has_key?(:'date_of_birth')
-          self.date_of_birth = attributes[:'date_of_birth']
+        if attributes.has_key?(:'dates_of_birth')
+          self.dates_of_birth = attributes[:'dates_of_birth']
+        elsif attributes.has_key?(:'date_of_birth')
+          self.dates_of_birth = [attributes[:'date_of_birth']]
         end
 
-        if attributes.has_key?(:'last_name')
-          self.last_name = attributes[:'last_name']
+        if attributes.has_key?(:'last_names')
+          self.last_names = attributes[:'last_names']
+        elsif attributes.has_key?(:'last_name')
+          self.last_names = [attributes[:'last_name']]
         end
 
-        if attributes.has_key?(:'first_name')
-          self.first_name = attributes[:'first_name']
+        if attributes.has_key?(:'first_names')
+          self.first_names = attributes[:'first_names']
+        elsif attributes.has_key?(:'first_name')
+          self.first_names = [attributes[:'first_name']]
         end
 
-        if attributes.has_key?(:'city')
-          self.city = attributes[:'city']
+        if attributes.has_key?(:'cities')
+          self.cities = attributes[:'cities']
+        elsif attributes.has_key?(:'city')
+          self.cities = [attributes[:'city']]
         end
 
-        if attributes.has_key?(:'country_code')
-          self.country_code = attributes[:'country_code']
+        if attributes.has_key?(:'country_codes')
+          self.country_codes = attributes[:'country_codes']
+        elsif attributes.has_key?(:'country_code')
+          self.country_codes = [attributes[:'country_code']]
         end
 
-        if attributes.has_key?(:'state')
-          self.state = attributes[:'state']
+        if attributes.has_key?(:'states')
+          self.states = attributes[:'states']
+        elsif attributes.has_key?(:'state')
+          self.states = [attributes[:'state']]
         end
 
-        if attributes.has_key?(:'zip_code')
-          self.zip_code = attributes[:'zip_code']
+        if attributes.has_key?(:'zip_codes')
+          self.zip_codes = attributes[:'zip_codes']
+        elsif attributes.has_key?(:'zip_code')
+          self.zip_codes = [attributes[:'zip_code']]
         end
 
-        if attributes.has_key?(:'external_id')
-          self.external_id = attributes[:'external_id']
+        if attributes.has_key?(:'external_ids')
+          self.external_ids = attributes[:'external_ids']
+        elsif attributes.has_key?(:'external_id')
+          self.external_ids = [attributes[:'external_id']]
         end
 
         if attributes.has_key?(:'client_ip_address')
@@ -313,17 +497,17 @@ module FacebookAds
       def ==(o)
         return true if self.equal?(o)
         self.class == o.class &&
-            email == o.email &&
-            phone == o.phone &&
-            gender == o.gender &&
-            date_of_birth == o.date_of_birth &&
-            last_name == o.last_name &&
-            first_name == o.first_name &&
-            city == o.city &&
-            country_code == o.country_code &&
-            state == o.state &&
-            zip_code == o.zip_code &&
-            external_id == o.external_id &&
+            emails == o.emails &&
+            phones == o.phones &&
+            genders == o.genders &&
+            dates_of_birth == o.dates_of_birth &&
+            last_names == o.last_names &&
+            first_names == o.first_names &&
+            cities == o.cities &&
+            country_codes == o.country_codes &&
+            states == o.states &&
+            zip_codes == o.zip_codes &&
+            external_ids == o.external_ids &&
             client_ip_address == o.client_ip_address &&
             client_user_agent == o.client_user_agent &&
             fbc == o.fbc &&
@@ -347,17 +531,17 @@ module FacebookAds
       # @return [Fixnum] Hash code
       def hash
         [
-            email,
-            phone,
-            gender,
-            date_of_birth,
-            last_name,
-            first_name,
-            city,
-            country_code,
-            state,
-            zip_code,
-            external_id,
+            emails,
+            phones,
+            genders,
+            dates_of_birth,
+            last_names,
+            first_names,
+            cities,
+            country_codes,
+            states,
+            zip_codes,
+            external_ids,
             client_ip_address,
             client_user_agent,
             fbc,
@@ -378,38 +562,38 @@ module FacebookAds
       # @return [String] String presentation of the object
       def to_s
         hash = {}
-        unless email.nil?
-          hash['email'] = email
+        unless emails.nil?
+          hash['emails'] = emails
         end
-        unless phone.nil?
-          hash['phone'] = phone
+        unless phones.nil?
+          hash['phones'] = phones
         end
-        unless gender.nil?
-          hash['gender'] = gender
+        unless genders.nil?
+          hash['genders'] = genders
         end
-        unless date_of_birth.nil?
-          hash['date_of_birth'] = date_of_birth
+        unless dates_of_birth.nil?
+          hash['dates_of_birth'] = dates_of_birth
         end
-        unless last_name.nil?
-          hash['last_name'] = last_name
+        unless last_names.nil?
+          hash['last_names'] = last_names
         end
-        unless first_name.nil?
-          hash['first_name'] = first_name
+        unless first_names.nil?
+          hash['first_names'] = first_names
         end
-        unless city.nil?
-          hash['city'] = city
+        unless cities.nil?
+          hash['cities'] = cities
         end
-        unless country_code.nil?
-          hash['country_code'] = country_code
+        unless country_codes.nil?
+          hash['country_codes'] = country_codes
         end
-        unless state.nil?
-          hash['state'] = state
+        unless states.nil?
+          hash['states'] = states
         end
-        unless zip_code.nil?
-          hash['zip_code'] = zip_code
+        unless zip_codes.nil?
+          hash['zip_codes'] = zip_codes
         end
-        unless external_id.nil?
-          hash['external_id'] = external_id
+        unless external_ids.nil?
+          hash['external_ids'] = external_ids
         end
         unless client_ip_address.nil?
           hash['client_ip_address'] = client_ip_address
@@ -455,37 +639,37 @@ module FacebookAds
       def normalize
         hash = {}
         unless email.nil?
-          hash['em'] = FacebookAds::ServerSide::Util.normalize(email, 'em')
+          hash['em'] = FacebookAds::ServerSide::Util.normalize_array(emails, 'em')
         end
         unless phone.nil?
-          hash['ph'] = FacebookAds::ServerSide::Util.normalize(phone, 'ph')
+          hash['ph'] = FacebookAds::ServerSide::Util.normalize_array(phones, 'ph')
         end
         unless gender.nil?
-          hash['ge'] = FacebookAds::ServerSide::Util.normalize(gender, 'ge')
+          hash['ge'] = FacebookAds::ServerSide::Util.normalize_array(genders, 'ge')
         end
         unless date_of_birth.nil?
-          hash['db'] = FacebookAds::ServerSide::Util.normalize(date_of_birth, 'db')
+          hash['db'] = FacebookAds::ServerSide::Util.normalize_array(dates_of_birth, 'db')
         end
         unless last_name.nil?
-          hash['ln'] = FacebookAds::ServerSide::Util.normalize(last_name, 'ln')
+          hash['ln'] = FacebookAds::ServerSide::Util.normalize_array(last_names, 'ln')
         end
         unless first_name.nil?
-          hash['fn'] = FacebookAds::ServerSide::Util.normalize(first_name, 'fn')
+          hash['fn'] = FacebookAds::ServerSide::Util.normalize_array(first_names, 'fn')
         end
         unless city.nil?
-          hash['ct'] = FacebookAds::ServerSide::Util.normalize(city, 'ct')
+          hash['ct'] = FacebookAds::ServerSide::Util.normalize_array(cities, 'ct')
         end
         unless country_code.nil?
-          hash['country'] = FacebookAds::ServerSide::Util.normalize(country_code, 'country')
+          hash['country'] = FacebookAds::ServerSide::Util.normalize_array(country_codes, 'country')
         end
         unless state.nil?
-          hash['st'] = FacebookAds::ServerSide::Util.normalize(state, 'st')
+          hash['st'] = FacebookAds::ServerSide::Util.normalize_array(states, 'st')
         end
         unless zip_code.nil?
-          hash['zp'] = FacebookAds::ServerSide::Util.normalize(zip_code, 'zp')
+          hash['zp'] = FacebookAds::ServerSide::Util.normalize_array(zip_codes, 'zp')
         end
         unless external_id.nil?
-          hash['external_id'] = external_id
+          hash['external_id'] = external_ids
         end
         unless client_ip_address.nil?
           hash['client_ip_address'] = client_ip_address
@@ -523,7 +707,17 @@ module FacebookAds
         unless doby.nil?
           hash['doby'] = FacebookAds::ServerSide::Util.normalize(doby, 'doby')
         end
-        hash
+        hash.select{|k, v| !v.nil?}
+      end
+
+      def validate_constructor_values(multi_value, single_value, multi_string, single_string)
+        if !multi_value.nil? && !single_value.nil?
+          raise ArgumentError.new(
+            'Cannot set both %s and %s parameters via constructor. ' % [
+              multi_string, single_string
+            ] + 'Please set either the multi or single parameter, not both.'
+          )
+        end
       end
     end
   end