facebookbusiness 0.9.0.0 → 0.10.0.1

data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb

@@ -42,6 +42,7 @@ module FacebookAds
       "EXPANDED_AUDIENCE",
       "EXTERNAL_IDS",
       "EXTERNAL_IDS_MIX",
+      "FACEBOOK_WIFI_EVENTS",
       "FB_EVENT_SIGNALS",
       "FB_PIXEL_HITS",
       "HASHES",

data/lib/facebook_ads/ad_objects/delivery_window.rb

@@ -0,0 +1,287 @@
+# Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
+#
+# You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
+# copy, modify, and distribute this software in source code or binary form for use
+# in connection with the web services and APIs provided by Facebook.
+#
+# As with any software that integrates with the Facebook platform, your use of
+# this software is subject to the Facebook Platform Policy
+# [http://developers.facebook.com/policy/]. This copyright notice shall be
+# included in all copies or substantial portions of the software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# FB:AUTOGEN
+
+module FacebookAds
+  # This class is auto-generated.
+
+  # For any issues or feature requests related to this class, please let us know
+  # on github and we'll fix in our codegen framework. We'll not be able to accept
+  # pull request for this class.
+
+  class DeliveryWindow < AdObject
+
+    field :ad, 'int'
+    field :ae, 'int'
+    field :af, 'int'
+    field :ag, 'int'
+    field :ai, 'int'
+    field :al, 'int'
+    field :all, 'int'
+    field :am, 'int'
+    field :an, 'int'
+    field :ao, 'int'
+    field :aq, 'int'
+    field :ar, 'int'
+    field :as, 'int'
+    field :at, 'int'
+    field :au, 'int'
+    field :aw, 'int'
+    field :ax, 'int'
+    field :az, 'int'
+    field :ba, 'int'
+    field :bb, 'int'
+    field :bd, 'int'
+    field :be, 'int'
+    field :bf, 'int'
+    field :bg, 'int'
+    field :bh, 'int'
+    field :bi, 'int'
+    field :bj, 'int'
+    field :bl, 'int'
+    field :bm, 'int'
+    field :bn, 'int'
+    field :bo, 'int'
+    field :bq, 'int'
+    field :br, 'int'
+    field :bs, 'int'
+    field :bt, 'int'
+    field :bv, 'int'
+    field :bw, 'int'
+    field :by, 'int'
+    field :bz, 'int'
+    field :ca, 'int'
+    field :cc, 'int'
+    field :cd, 'int'
+    field :cf, 'int'
+    field :cg, 'int'
+    field :ch, 'int'
+    field :ci, 'int'
+    field :ck, 'int'
+    field :cl, 'int'
+    field :cm, 'int'
+    field :cn, 'int'
+    field :co, 'int'
+    field :cr, 'int'
+    field :cu, 'int'
+    field :cv, 'int'
+    field :cw, 'int'
+    field :cx, 'int'
+    field :cy, 'int'
+    field :cz, 'int'
+    field :de, 'int'
+    field :dj, 'int'
+    field :dk, 'int'
+    field :dm, 'int'
+    field :_do, 'int'
+    field :dz, 'int'
+    field :ec, 'int'
+    field :ee, 'int'
+    field :eg, 'int'
+    field :eh, 'int'
+    field :er, 'int'
+    field :es, 'int'
+    field :et, 'int'
+    field :fi, 'int'
+    field :fj, 'int'
+    field :fk, 'int'
+    field :fm, 'int'
+    field :fo, 'int'
+    field :fr, 'int'
+    field :ga, 'int'
+    field :gb, 'int'
+    field :gd, 'int'
+    field :ge, 'int'
+    field :gf, 'int'
+    field :gg, 'int'
+    field :gh, 'int'
+    field :gi, 'int'
+    field :gl, 'int'
+    field :gm, 'int'
+    field :gn, 'int'
+    field :gp, 'int'
+    field :gq, 'int'
+    field :gr, 'int'
+    field :gs, 'int'
+    field :gt, 'int'
+    field :gu, 'int'
+    field :gw, 'int'
+    field :gy, 'int'
+    field :hk, 'int'
+    field :hm, 'int'
+    field :hn, 'int'
+    field :hr, 'int'
+    field :ht, 'int'
+    field :hu, 'int'
+    field :id, 'int'
+    field :ie, 'int'
+    field :il, 'int'
+    field :im, 'int'
+    field :in, 'int'
+    field :io, 'int'
+    field :iq, 'int'
+    field :ir, 'int'
+    field :is, 'int'
+    field :it, 'int'
+    field :je, 'int'
+    field :jm, 'int'
+    field :jo, 'int'
+    field :jp, 'int'
+    field :ke, 'int'
+    field :kg, 'int'
+    field :kh, 'int'
+    field :ki, 'int'
+    field :km, 'int'
+    field :kn, 'int'
+    field :kp, 'int'
+    field :kr, 'int'
+    field :kw, 'int'
+    field :ky, 'int'
+    field :kz, 'int'
+    field :la, 'int'
+    field :lb, 'int'
+    field :lc, 'int'
+    field :li, 'int'
+    field :lk, 'int'
+    field :lr, 'int'
+    field :ls, 'int'
+    field :lt, 'int'
+    field :lu, 'int'
+    field :lv, 'int'
+    field :ly, 'int'
+    field :ma, 'int'
+    field :mc, 'int'
+    field :md, 'int'
+    field :me, 'int'
+    field :mf, 'int'
+    field :mg, 'int'
+    field :mh, 'int'
+    field :mk, 'int'
+    field :ml, 'int'
+    field :mm, 'int'
+    field :mn, 'int'
+    field :mo, 'int'
+    field :mp, 'int'
+    field :mq, 'int'
+    field :mr, 'int'
+    field :ms, 'int'
+    field :mt, 'int'
+    field :mu, 'int'
+    field :mv, 'int'
+    field :mw, 'int'
+    field :mx, 'int'
+    field :my, 'int'
+    field :mz, 'int'
+    field :na, 'int'
+    field :nc, 'int'
+    field :ne, 'int'
+    field :nf, 'int'
+    field :ng, 'int'
+    field :ni, 'int'
+    field :nl, 'int'
+    field :no, 'int'
+    field :np, 'int'
+    field :nr, 'int'
+    field :nu, 'int'
+    field :nz, 'int'
+    field :om, 'int'
+    field :pa, 'int'
+    field :pe, 'int'
+    field :pf, 'int'
+    field :pg, 'int'
+    field :ph, 'int'
+    field :pk, 'int'
+    field :pl, 'int'
+    field :pm, 'int'
+    field :pn, 'int'
+    field :pr, 'int'
+    field :ps, 'int'
+    field :pt, 'int'
+    field :pw, 'int'
+    field :py, 'int'
+    field :qa, 'int'
+    field :re, 'int'
+    field :ro, 'int'
+    field :rs, 'int'
+    field :ru, 'int'
+    field :rw, 'int'
+    field :sa, 'int'
+    field :sb, 'int'
+    field :sc, 'int'
+    field :sd, 'int'
+    field :se, 'int'
+    field :sg, 'int'
+    field :sh, 'int'
+    field :si, 'int'
+    field :sj, 'int'
+    field :sk, 'int'
+    field :sl, 'int'
+    field :sm, 'int'
+    field :sn, 'int'
+    field :so, 'int'
+    field :sr, 'int'
+    field :ss, 'int'
+    field :st, 'int'
+    field :sv, 'int'
+    field :sx, 'int'
+    field :sy, 'int'
+    field :sz, 'int'
+    field :tc, 'int'
+    field :td, 'int'
+    field :tf, 'int'
+    field :tg, 'int'
+    field :th, 'int'
+    field :tj, 'int'
+    field :tk, 'int'
+    field :tl, 'int'
+    field :tm, 'int'
+    field :tn, 'int'
+    field :to, 'int'
+    field :tr, 'int'
+    field :tt, 'int'
+    field :tv, 'int'
+    field :tw, 'int'
+    field :tz, 'int'
+    field :ua, 'int'
+    field :ug, 'int'
+    field :um, 'int'
+    field :us, 'int'
+    field :uy, 'int'
+    field :uz, 'int'
+    field :va, 'int'
+    field :vc, 'int'
+    field :ve, 'int'
+    field :vg, 'int'
+    field :vi, 'int'
+    field :vn, 'int'
+    field :vu, 'int'
+    field :wf, 'int'
+    field :ws, 'int'
+    field :xk, 'int'
+    field :ye, 'int'
+    field :yt, 'int'
+    field :za, 'int'
+    field :zm, 'int'
+    field :zw, 'int'
+    has_no_get
+    has_no_post
+    has_no_delete
+
+  end
+end

data/lib/facebook_ads/ad_objects/destination.rb

@@ -26,6 +26,15 @@ module FacebookAds
   # pull request for this class.
 
   class Destination < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
 
     field :address, 'string'
     field :applinks, 'CatalogItemAppLinks'
@@ -34,6 +43,7 @@ module FacebookAds
     field :description, 'string'
     field :destination_id, 'string'
     field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
     field :images, { list: 'string' }
     field :name, 'string'
     field :price, 'string'
@@ -44,5 +54,13 @@ module FacebookAds
     has_no_post
     has_no_delete
 
+    has_edge :augmented_realities_metadata do |edge|
+      edge.get
+    end
+
+    has_edge :videos_metadata do |edge|
+      edge.get
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/flight.rb

@@ -26,6 +26,15 @@ module FacebookAds
   # pull request for this class.
 
   class Flight < AdObject
+    IMAGE_FETCH_STATUS = [
+      "DIRECT_UPLOAD",
+      "FETCHED",
+      "FETCH_FAILED",
+      "NO_STATUS",
+      "OUTDATED",
+      "PARTIAL_FETCH",
+    ]
+
 
     field :applinks, 'CatalogItemAppLinks'
     field :category_specific_fields, 'CatalogSubVerticalList'
@@ -35,6 +44,7 @@ module FacebookAds
     field :destination_city, 'string'
     field :flight_id, 'string'
     field :id, 'string'
+    field :image_fetch_status, { enum: -> { IMAGE_FETCH_STATUS }}
     field :images, { list: 'string' }
     field :oneway_currency, 'string'
     field :oneway_price, 'string'
@@ -45,5 +55,13 @@ module FacebookAds
     field :url, 'string'
     has_no_delete
 
+    has_edge :augmented_realities_metadata do |edge|
+      edge.get
+    end
+
+    has_edge :videos_metadata do |edge|
+      edge.get
+    end
+
   end
 end

data/lib/facebook_ads/ad_objects/group.rb

@@ -150,15 +150,6 @@ module FacebookAds
       "WORK_VC_CALL",
     ]
 
-    SUGGESTION_CATEGORY = [
-      "EVENT",
-      "MESSENGER",
-      "WORK",
-      "WORKPLACE",
-      "WORKPLACE_1_1",
-      "WORKPLACE_MANAGER",
-    ]
-
 
     field :archived, 'bool'
     field :cover, 'CoverPhoto'
@@ -171,7 +162,6 @@ module FacebookAds
     field :member_count, 'int'
     field :member_request_count, 'int'
     field :name, 'string'
-    field :owner, 'object'
     field :parent, 'object'
     field :permissions, { list: 'string' }
     field :privacy, 'string'
@@ -216,7 +206,15 @@ module FacebookAds
     end
 
     has_edge :feed do |edge|
-      edge.post do |api|
+      edge.get 'Post' do |api|
+        api.has_param :include_hidden, 'bool'
+        api.has_param :q, 'string'
+        api.has_param :show_expired, 'bool'
+        api.has_param :since, 'datetime'
+        api.has_param :until, 'datetime'
+        api.has_param :with, 'string'
+      end
+      edge.post 'Post' do |api|
         api.has_param :actions, 'object'
         api.has_param :adaptive_type, 'string'
         api.has_param :album_id, 'string'
@@ -230,10 +228,10 @@ module FacebookAds
         api.has_param :attached_media, { list: 'object' }
         api.has_param :audience_exp, 'bool'
         api.has_param :backdated_time, 'datetime'
-        api.has_param :backdated_time_granularity, { enum: %w{day hour min month none year }}
+        api.has_param :backdated_time_granularity, { enum: -> { Post::BACKDATED_TIME_GRANULARITY }}
         api.has_param :call_to_action, 'object'
         api.has_param :caption, 'string'
-        api.has_param :checkin_entry_point, { enum: %w{BRANDING_CHECKIN BRANDING_OTHER BRANDING_PHOTO BRANDING_STATUS }}
+        api.has_param :checkin_entry_point, { enum: -> { Post::CHECKIN_ENTRY_POINT }}
         api.has_param :child_attachments, { list: 'object' }
         api.has_param :client_mutation_id, 'string'
         api.has_param :composer_entry_picker, 'string'
@@ -253,7 +251,7 @@ module FacebookAds
         api.has_param :expanded_height, 'int'
         api.has_param :expanded_width, 'int'
         api.has_param :feed_targeting, 'object'
-        api.has_param :formatting, { enum: %w{MARKDOWN PLAINTEXT }}
+        api.has_param :formatting, { enum: -> { Post::FORMATTING }}
         api.has_param :fun_fact_prompt_id, 'int'
         api.has_param :fun_fact_toastee_id, 'int'
         api.has_param :has_nickname, 'bool'
@@ -290,11 +288,11 @@ module FacebookAds
         api.has_param :page_recommendation, 'string'
         api.has_param :picture, 'string'
         api.has_param :place, 'object'
-        api.has_param :place_attachment_setting, { enum: %w{1 2 }}
+        api.has_param :place_attachment_setting, { enum: -> { Post::PLACE_ATTACHMENT_SETTING }}
         api.has_param :place_list, 'string'
         api.has_param :place_list_data, { list: 'string' }
-        api.has_param :post_surfaces_blacklist, { list: { enum: %w{1 2 3 4 5 }} }
-        api.has_param :posting_to_redspace, { enum: %w{disabled enabled }}
+        api.has_param :post_surfaces_blacklist, { list: { enum: -> { Post::POST_SURFACES_BLACKLIST }} }
+        api.has_param :posting_to_redspace, { enum: -> { Post::POSTING_TO_REDSPACE }}
         api.has_param :privacy, 'string'
         api.has_param :prompt_id, 'string'
         api.has_param :prompt_tracking_string, 'string'
@@ -314,7 +312,7 @@ module FacebookAds
         api.has_param :sponsor_relationship, 'int'
         api.has_param :suggested_place_id, 'object'
         api.has_param :tags, { list: 'int' }
-        api.has_param :target_surface, { enum: %w{STORY TIMELINE }}
+        api.has_param :target_surface, { enum: -> { Post::TARGET_SURFACE }}
         api.has_param :targeting, 'object'
         api.has_param :text_format_metadata, 'string'
         api.has_param :text_format_preset_id, 'string'
@@ -324,7 +322,7 @@ module FacebookAds
         api.has_param :time_since_original_post, 'int'
         api.has_param :title, 'string'
         api.has_param :tracking_info, 'string'
-        api.has_param :unpublished_content_type, { enum: %w{ADS_POST DRAFT INLINE_CREATED PUBLISHED REVIEWABLE_BRANDED_CONTENT SCHEDULED SCHEDULED_RECURRING }}
+        api.has_param :unpublished_content_type, { enum: -> { Post::UNPUBLISHED_CONTENT_TYPE }}
         api.has_param :user_selected_tags, 'bool'
         api.has_param :video_start_time_ms, 'int'
         api.has_param :viewer_coordinates, 'object'
@@ -332,6 +330,10 @@ module FacebookAds
       end
     end
 
+    has_edge :files do |edge|
+      edge.get
+    end
+
     has_edge :groups do |edge|
       edge.get 'Group'
       edge.post 'Group' do |api|
@@ -346,8 +348,14 @@ module FacebookAds
         api.has_param :post_requires_admin_approval, 'bool'
         api.has_param :privacy, 'string'
         api.has_param :ref, 'string'
-        api.has_param :suggestion_category, { enum: -> { Group::SUGGESTION_CATEGORY }}
-        api.has_param :suggestion_identifier, 'string'
+      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
 
@@ -466,6 +474,15 @@ 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 }}
@@ -475,7 +492,6 @@ module FacebookAds
         api.has_param :animated_effect_id, 'int'
         api.has_param :application_id, 'string'
         api.has_param :asked_fun_fact_prompt_id, 'int'
-        api.has_param :attribution_app_id, 'string'
         api.has_param :audio_story_wave_animation_handle, 'string'
         api.has_param :composer_entry_picker, 'string'
         api.has_param :composer_entry_point, 'string'