facebookbusiness 0.15.0.2 → 0.16.0.1

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

@@ -0,0 +1,344 @@
+# 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.
+
+
+module FacebookAds
+  module ServerSide
+    # ExtendedDeviceInfo, such as screen width and height. This parameter is an array and values are separated by commas.
+    class ExtendedDeviceInfo
+
+        attr_accessor :ext_info_version,
+                      :app_package_name,
+                      :short_version,
+                      :long_version,
+                      :os_version,
+                      :device_model_name,
+                      :locale,
+                      :timezone_abbreviation,
+                      :carrier,
+                      :screen_width,
+                      :screen_height,
+                      :screen_density,
+                      :cpu_core_count,
+                      :total_disk_space_gb,
+                      :free_disk_space_gb,
+                      :device_time_zone
+
+        # Initializes the object
+        # @param [String] ext_info_version
+        # @param [String] app_package_name
+        # @param [String] short_version
+        # @param [String] long_version
+        # @param [String] os_version
+        # @param [String] device_model_name
+        # @param [String] locale
+        # @param [String] timezone_abbreviation
+        # @param [String] carrier
+        # @param [String] screen_width
+        # @param [String] screen_height
+        # @param [String] screen_density
+        # @param [String] cpu_core_count
+        # @param [String] total_disk_space_gb
+        # @param [String] free_disk_space_gb
+        # @param [String] device_time_zone
+        def initialize(ext_info_version: nil, app_package_name: nil, short_version: nil, long_version: nil, os_version: nil, device_model_name: nil, locale: nil, timezone_abbreviation: nil,
+            carrier: nil, screen_width: nil, screen_height: nil, screen_density: nil, cpu_core_count: nil, total_disk_space_gb: nil, free_disk_space_gb: nil, device_time_zone: nil)
+            unless ext_info_version.nil?
+              self.ext_info_version = String(ext_info_version)
+            end
+            unless app_package_name.nil?
+              self.app_package_name = String(app_package_name)
+            end
+            unless short_version.nil?
+              self.short_version = String(short_version)
+            end
+            unless long_version.nil?
+              self.long_version = String(long_version)
+            end
+            unless os_version.nil?
+              self.os_version = String(os_version)
+            end
+            unless device_model_name.nil?
+              self.device_model_name = String(device_model_name)
+            end
+            unless locale.nil?
+              self.locale = String(locale)
+            end
+            unless timezone_abbreviation.nil?
+              self.timezone_abbreviation = String(timezone_abbreviation)
+            end
+            unless carrier.nil?
+                self.carrier = String(carrier)
+            end
+            unless screen_width.nil?
+                self.screen_width = String(screen_width)
+            end
+            unless screen_height.nil?
+                self.screen_height = String(screen_height)
+            end
+            unless screen_density.nil?
+                self.screen_density = String(screen_density)
+            end
+            unless cpu_core_count.nil?
+                self.cpu_core_count = String(cpu_core_count)
+            end
+            unless total_disk_space_gb.nil?
+                self.total_disk_space_gb = String(total_disk_space_gb)
+            end
+            unless free_disk_space_gb.nil?
+                self.free_disk_space_gb = String(free_disk_space_gb)
+            end
+            unless device_time_zone.nil?
+                self.device_time_zone = String(device_time_zone)
+            end
+        end
+
+        # build the object using the input hash
+        # @param [Hash] attributes  attributes in the form of hash
+        def build(attributes = {})
+            return unless attributes.is_a?(Hash)
+
+            # convert string to symbol for hash key
+            attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+            if attributes.has_key?(:'ext_info_version')
+                self.ext_info_version = attributes[:'ext_info_version']
+            end
+
+              if attributes.has_key?(:'app_package_name')
+                self.app_package_name = attributes[:'app_package_name']
+              end
+
+              if attributes.has_key?(:'short_version')
+                self.short_version = attributes[:'short_version']
+              end
+
+              if attributes.has_key?(:'long_version')
+                self.long_version = attributes[:'long_version']
+              end
+
+              if attributes.has_key?(:'os_version')
+                self.os_version = attributes[:'os_version']
+              end
+
+              if attributes.has_key?(:'device_model_name')
+                self.device_model_name = attributes[:'device_model_name']
+              end
+
+              if attributes.has_key?(:'locale')
+                self.locale = attributes[:'locale']
+              end
+
+              if attributes.has_key?(:'timezone_abbreviation')
+                self.timezone_abbreviation = attributes[:'timezone_abbreviation']
+              end
+
+              if attributes.has_key?(:'carrier')
+                self.carrier = attributes[:'carrier']
+              end
+
+              if attributes.has_key?(:'screen_width')
+                self.screen_width = attributes[:'screen_width']
+              end
+
+              if attributes.has_key?(:'screen_height')
+                self.screen_height = attributes[:'screen_height']
+              end
+
+              if attributes.has_key?(:'screen_density')
+                self.screen_density = attributes[:'screen_density']
+              end
+
+              if attributes.has_key?(:'cpu_core_count')
+                self.cpu_core_count = attributes[:'cpu_core_count']
+              end
+
+              if attributes.has_key?(:'total_disk_space_gb')
+                self.total_disk_space_gb = attributes[:'total_disk_space_gb']
+              end
+
+              if attributes.has_key?(:'free_disk_space_gb')
+                self.free_disk_space_gb = attributes[:'free_disk_space_gb']
+              end
+
+              if attributes.has_key?(:'device_time_zone')
+                self.device_time_zone = attributes[:'device_time_zone']
+              end
+        end
+
+
+        # Checks equality by comparing each attribute.
+        def ==(o)
+            return self.class == o.class &&
+                ext_info_version == o.ext_info_version &&
+                app_package_name == o.app_package_name &&
+                short_version == o.short_version &&
+                long_version == o.long_version &&
+                os_version == o.os_version &&
+                device_model_name == o.device_model_name &&
+                locale == o.locale &&
+                timezone_abbreviation == o.timezone_abbreviation &&
+                carrier == o.carrier &&
+                screen_width == o.screen_width &&
+                screen_height == o.screen_height &&
+                screen_density == o.screen_density &&
+                cpu_core_count == o.cpu_core_count &&
+                total_disk_space_gb == o.total_disk_space_gb &&
+                free_disk_space_gb == o.free_disk_space_gb &&
+                device_time_zone == o.device_time_zone
+        end
+
+        # @see the `==` method
+        def eql?(o)
+            self == o
+        end
+
+        # Calculates hash code according to all attributes.
+        # @return [Fixnum] Hash code
+        def hash
+            [
+                ext_info_version,
+                app_package_name,
+                short_version,
+                long_version,
+                os_version,
+                device_model_name,
+                locale,
+                timezone_abbreviation,
+                carrier,
+                screen_width,
+                screen_height,
+                screen_density,
+                cpu_core_count,
+                total_disk_space_gb,
+                free_disk_space_gb,
+                device_time_zone
+            ].hash
+        end
+
+        # Returns the string representation of the object
+        # @return [String] String presentation of the object
+        def to_s
+          hash = {}
+          unless ext_info_version.nil?
+            hash['ext_info_version'] = ext_info_version
+          end
+          unless app_package_name.nil?
+            hash['app_package_name'] = app_package_name
+          end
+          unless short_version.nil?
+            hash['short_version'] = short_version
+          end
+          unless long_version.nil?
+            hash['long_version'] = long_version
+          end
+          unless os_version.nil?
+            hash['os_version'] = os_version
+          end
+          unless device_model_name.nil?
+            hash['device_model_name'] = device_model_name
+          end
+          unless locale.nil?
+            hash['locale'] = locale
+          end
+          unless timezone_abbreviation.nil?
+            hash['timezone_abbreviation'] = timezone_abbreviation
+          end
+          unless carrier.nil?
+            hash['carrier'] = carrier
+          end
+          unless screen_width.nil?
+            hash['screen_width'] = screen_width
+          end
+          unless screen_height.nil?
+            hash['screen_height'] = screen_height
+          end
+          unless screen_density.nil?
+            hash['screen_density'] = screen_density
+          end
+          unless cpu_core_count.nil?
+            hash['cpu_core_count'] = cpu_core_count
+          end
+          unless total_disk_space_gb.nil?
+            hash['total_disk_space_gb'] = total_disk_space_gb
+          end
+          unless free_disk_space_gb.nil?
+            hash['free_disk_space_gb'] = free_disk_space_gb
+          end
+          unless device_time_zone.nil?
+            hash['device_time_zone'] = device_time_zone
+          end
+          hash.to_s
+        end
+
+        # Normalize input fields to server request format.
+        def normalize
+          ext_info_array = []
+          unless ext_info_version.nil?
+            ext_info_array.push(ext_info_version)
+          end
+          unless app_package_name.nil?
+            ext_info_array.push(app_package_name)
+          end
+          unless short_version.nil?
+            ext_info_array.push(short_version)
+          end
+          unless long_version.nil?
+            ext_info_array.push(long_version)
+          end
+          unless os_version.nil?
+            ext_info_array.push(os_version)
+          end
+          unless device_model_name.nil?
+            ext_info_array.push(device_model_name)
+          end
+          unless locale.nil?
+            ext_info_array.push(locale)
+          end
+          unless timezone_abbreviation.nil?
+            ext_info_array.push(timezone_abbreviation)
+          end
+          unless carrier.nil?
+            ext_info_array.push(carrier)
+          end
+          unless screen_width.nil?
+            ext_info_array.push(screen_width)
+          end
+          unless screen_height.nil?
+            ext_info_array.push(screen_height)
+          end
+          unless screen_density.nil?
+            ext_info_array.push(screen_density)
+          end
+          unless cpu_core_count.nil?
+            ext_info_array.push(cpu_core_count)
+          end
+          unless total_disk_space_gb.nil?
+            ext_info_array.push(total_disk_space_gb)
+          end
+          unless free_disk_space_gb.nil?
+            ext_info_array.push(free_disk_space_gb)
+          end
+          unless device_time_zone.nil?
+            ext_info_array.push(device_time_zone)
+          end
+          ext_info_array
+        end
+    end
+  end
+end

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

@@ -216,6 +216,27 @@ module FacebookAds
       # The date of birth year.
       attr_accessor :doby
 
+      # Your Install ID. This field represents unique application installation instances.
+      attr_accessor :anon_ids
+
+      def anon_id
+        @anon_ids ? @anon_ids[0] : nil
+      end
+      def anon_id=(anon_id)
+        @anon_ids = [anon_id]
+      end
+
+      # Your mobile advertiser ID, the advertising ID from an Android device or the Advertising Identifier (IDFA) from an Apple device.
+      attr_accessor :madids
+
+      def madid
+        @madids ? @madids[0] : nil
+      end
+      def madid=(madid)
+        @madids = [madid]
+      end
+
+
       #UserData is a set of identifiers Facebook can use for targeted attribution
       # @param [String] email
       # @param [Array<String>] emails
@@ -251,13 +272,17 @@ module FacebookAds
       # @param [String] dobd
       # @param [String] dobm
       # @param [String] doby
+      # @param [String] anon_id
+      # @param [Array<String>] anon_ids
+      # @param [String] madid
+      # @param [Array<String>] madids
       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)
+                     f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil, anon_id: nil, anon_ids: nil, madid:nil, madids: nil)
         validate_constructor_values(emails, email, 'emails', 'email')
         validate_constructor_values(phones, phone, 'phones', 'phone')
         validate_constructor_values(genders, gender, 'genders', 'gender')
@@ -372,6 +397,18 @@ module FacebookAds
         unless doby.nil?
           self.doby = doby
         end
+        unless anon_id.nil?
+          self.anon_id = anon_id
+        end
+        unless anon_ids.nil?
+          self.anon_ids = anon_ids
+        end
+        unless madid.nil?
+          self.madid = madid
+        end
+        unless madids.nil?
+          self.madids = madids
+        end
       end
 
       # build the object using the input hash
@@ -491,6 +528,18 @@ module FacebookAds
         if attributes.has_key?(:'doby')
           self.doby = attributes[:'doby']
         end
+
+        if attributes.has_key?(:'anon_ids')
+          self.anon_ids = attributes[:'anon_ids']
+        elsif attributes.has_key?(:'anon_id')
+          self.anon_ids = [attributes[:'anon_id']]
+        end
+
+        if attributes.has_key?(:'madids')
+          self.madids = attributes[:'madids']
+        elsif attributes.has_key?(:'madid')
+          self.madids = [attributes[:'madid']]
+        end
       end
 
       # Checks equality by comparing each attribute.
@@ -519,7 +568,9 @@ module FacebookAds
             fi == o.fi &&
             dobd == o.dobd &&
             dobm == o.dobm &&
-            doby == o.doby
+            doby == o.doby &&
+            anon_ids == o.anon_ids &&
+            madids == o.madids
       end
 
       # @see the `==` method
@@ -554,6 +605,8 @@ module FacebookAds
             dobd,
             dobm,
             doby,
+            anon_ids,
+            madids
         ].hash
 
       end
@@ -631,6 +684,12 @@ module FacebookAds
         unless doby.nil?
           hash['doby'] = doby
         end
+        unless anon_ids.nil?
+          hash['anon_ids'] = anon_ids
+        end
+        unless madids.nil?
+          hash['madids'] = madids
+        end
         hash.to_s
       end
 
@@ -707,6 +766,12 @@ module FacebookAds
         unless doby.nil?
           hash['doby'] = FacebookAds::ServerSide::Util.normalize(doby, 'doby')
         end
+        unless anon_id.nil?
+          hash['anon_id'] = anon_ids
+        end
+        unless madid.nil?
+          hash['madid'] = madids
+        end
         hash.select{|k, v| !v.nil?}
       end
 

data/lib/facebook_ads/ad_objects/user.rb

@@ -99,6 +99,7 @@ module FacebookAds
       edge.delete
       edge.post 'User' do |api|
         api.has_param :business_app, 'int'
+        api.has_param :is_permanent_token, 'bool'
         api.has_param :page_id, 'string'
         api.has_param :scope, { list: 'Permission' }
       end
@@ -474,6 +475,7 @@ module FacebookAds
 
     has_edge :notifications do |edge|
       edge.post 'User' do |api|
+        api.has_param :bot_message_payload_elements, 'string'
         api.has_param :filtering, { list: { enum: -> { User::FILTERING }} }
         api.has_param :href, 'object'
         api.has_param :label, 'string'

data/lib/facebook_ads/ad_objects/user_page_one_time_opt_in_token_settings.rb

@@ -28,6 +28,7 @@ module FacebookAds
   class UserPageOneTimeOptInTokenSettings < AdObject
 
     field :creation_timestamp, 'int'
+    field :next_eligible_time, 'int'
     field :notification_messages_frequency, 'string'
     field :notification_messages_reoptin, 'string'
     field :notification_messages_timezone, 'string'

data/lib/facebook_ads/ad_objects/vehicle.rb

@@ -137,7 +137,6 @@ module FacebookAds
     field :condition, 'string'
     field :currency, 'string'
     field :custom_label_0, 'string'
-    field :custom_number_0, 'int'
     field :date_first_on_lot, 'string'
     field :dealer_communication_channel, 'string'
     field :dealer_email, 'string'

data/lib/facebook_ads/ad_objects/whats_app_business_account.rb

@@ -30,17 +30,17 @@ module FacebookAds
       "DEVELOP",
       "FULL_CONTROL",
       "MANAGE",
+      "MANAGE_EXTENSIONS",
       "MANAGE_PHONE",
       "MANAGE_TEMPLATES",
-      "MANAGE_TEMPLATES_AND_PHONE",
       "MESSAGING",
       "VIEW_COST",
     ]
 
     CATEGORY = [
+      "AUTHENTICATION",
       "MARKETING",
-      "OTP",
-      "TRANSACTIONAL",
+      "UTILITY",
     ]
 
 

data/lib/facebook_ads/edge.rb

@@ -70,7 +70,7 @@ module FacebookAds
         end
 
         self.next_page_cursor = response.dig('paging', 'cursors', 'after')
-        self.has_next_page = !(response['data'].length < fetch_options[:limit])
+        self.has_next_page = !!response.dig('paging', 'next')
       end
     end
 

data/lib/facebook_ads/field_types/upload_file.rb

@@ -77,7 +77,7 @@ module FacebookAds
         case value
           when String, File, Tempfile
             if value.is_a?(String)
-              raise InvalidParameterError, "No such file: #{value}" unless File.exists?(value)
+              raise InvalidParameterError, "No such file: #{value}" unless File.exist?(value)
               value = File.new(value)
             end
 
@@ -114,7 +114,7 @@ module FacebookAds
           return true if value.is_a?(type)
         end
 
-        value.is_a?(String) ? File.exists?(value) : false
+        value.is_a?(String) ? File.exist?(value) : false
       end
     end
   end

data/lib/facebook_ads/test/config.rb

@@ -41,7 +41,7 @@ module FacebookAds
 
       def override_from!(filename = nil)
         filename ||= File.expand_path("../../../../tests/test_config.json", __FILE__)
-        if File.exists?(filename)
+        if File.exist?(filename)
           settings = JSON.parse(File.read(filename))
 
           settings.each do |k,v|
@@ -52,4 +52,4 @@ module FacebookAds
       end
     end
   end
-end
+end

data/lib/facebook_ads/version.rb

@@ -19,6 +19,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '0.15.0.2'
-  API_VERSION = '15.0'
+  VERSION = '0.16.0.1'
+  API_VERSION = '16.0'
 end

data/lib/facebook_ads/videos/video_io.rb

@@ -16,6 +16,8 @@
 # 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.
 
+require 'faraday/multipart'
+
 module FacebookAds
   class VideoIO < ::UploadIO
     def is_video?