facebookbusiness 0.3.0.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (297) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE.txt +17 -0
  3. data/README.md +256 -0
  4. data/lib/facebook_ads.rb +72 -0
  5. data/lib/facebook_ads/ad_object.rb +177 -0
  6. data/lib/facebook_ads/ad_objects/ad.rb +243 -0
  7. data/lib/facebook_ads/ad_objects/ad_account.rb +771 -0
  8. data/lib/facebook_ads/ad_objects/ad_account_ad_rules_history.rb +59 -0
  9. data/lib/facebook_ads/ad_objects/ad_account_contextual_targeting.rb +36 -0
  10. data/lib/facebook_ads/ad_objects/ad_account_creation_request.rb +217 -0
  11. data/lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb +65 -0
  12. data/lib/facebook_ads/ad_objects/ad_account_roas.rb +97 -0
  13. data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb +151 -0
  14. data/lib/facebook_ads/ad_objects/ad_account_user.rb +40 -0
  15. data/lib/facebook_ads/ad_objects/ad_activity.rb +125 -0
  16. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb +98 -0
  17. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_asset_label.rb +37 -0
  18. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_body.rb +39 -0
  19. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_caption.rb +39 -0
  20. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_description.rb +39 -0
  21. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_group_rule.rb +43 -0
  22. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_image.rb +41 -0
  23. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_link_url.rb +42 -0
  24. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_title.rb +39 -0
  25. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_video.rb +42 -0
  26. data/lib/facebook_ads/ad_objects/ad_async_request.rb +67 -0
  27. data/lib/facebook_ads/ad_objects/ad_async_request_set.rb +68 -0
  28. data/lib/facebook_ads/ad_objects/ad_async_request_set_notification_result.rb +38 -0
  29. data/lib/facebook_ads/ad_objects/ad_campaign_delivery_estimate.rb +65 -0
  30. data/lib/facebook_ads/ad_objects/ad_campaign_frequency_control_specs.rb +39 -0
  31. data/lib/facebook_ads/ad_objects/ad_creative.rb +178 -0
  32. data/lib/facebook_ads/ad_objects/ad_creative_collection_thumbnail_info.rb +39 -0
  33. data/lib/facebook_ads/ad_objects/ad_creative_link_data.rb +79 -0
  34. data/lib/facebook_ads/ad_objects/ad_creative_link_data_app_link_spec.rb +40 -0
  35. data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb +87 -0
  36. data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action_value.rb +46 -0
  37. data/lib/facebook_ads/ad_objects/ad_creative_link_data_child_attachment.rb +47 -0
  38. data/lib/facebook_ads/ad_objects/ad_creative_link_data_custom_overlay_spec.rb +100 -0
  39. data/lib/facebook_ads/ad_objects/ad_creative_link_data_image_overlay_spec.rb +101 -0
  40. data/lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb +43 -0
  41. data/lib/facebook_ads/ad_objects/ad_creative_photo_data.rb +43 -0
  42. data/lib/facebook_ads/ad_objects/ad_creative_place_data.rb +42 -0
  43. data/lib/facebook_ads/ad_objects/ad_creative_post_click_configuration.rb +38 -0
  44. data/lib/facebook_ads/ad_objects/ad_creative_text_data.rb +37 -0
  45. data/lib/facebook_ads/ad_objects/ad_creative_video_data.rb +53 -0
  46. data/lib/facebook_ads/ad_objects/ad_image.rb +57 -0
  47. data/lib/facebook_ads/ad_objects/ad_keyword_stats.rb +55 -0
  48. data/lib/facebook_ads/ad_objects/ad_label.rb +57 -0
  49. data/lib/facebook_ads/ad_objects/ad_network_analytics_async_query_result.rb +41 -0
  50. data/lib/facebook_ads/ad_objects/ad_network_analytics_sync_query_result.rb +38 -0
  51. data/lib/facebook_ads/ad_objects/ad_place_page_set.rb +44 -0
  52. data/lib/facebook_ads/ad_objects/ad_preview.rb +62 -0
  53. data/lib/facebook_ads/ad_objects/ad_promoted_object.rb +64 -0
  54. data/lib/facebook_ads/ad_objects/ad_recommendation.rb +55 -0
  55. data/lib/facebook_ads/ad_objects/ad_recommendation_data.rb +37 -0
  56. data/lib/facebook_ads/ad_objects/ad_report_run.rb +71 -0
  57. data/lib/facebook_ads/ad_objects/ad_rule.rb +56 -0
  58. data/lib/facebook_ads/ad_objects/ad_rule_evaluation_spec.rb +44 -0
  59. data/lib/facebook_ads/ad_objects/ad_rule_execution_options.rb +44 -0
  60. data/lib/facebook_ads/ad_objects/ad_rule_execution_spec.rb +49 -0
  61. data/lib/facebook_ads/ad_objects/ad_rule_filters.rb +55 -0
  62. data/lib/facebook_ads/ad_objects/ad_rule_history.rb +58 -0
  63. data/lib/facebook_ads/ad_objects/ad_rule_history_result.rb +45 -0
  64. data/lib/facebook_ads/ad_objects/ad_rule_history_result_action.rb +40 -0
  65. data/lib/facebook_ads/ad_objects/ad_rule_schedule.rb +39 -0
  66. data/lib/facebook_ads/ad_objects/ad_rule_schedule_spec.rb +38 -0
  67. data/lib/facebook_ads/ad_objects/ad_rule_trigger.rb +63 -0
  68. data/lib/facebook_ads/ad_objects/ad_set.rb +300 -0
  69. data/lib/facebook_ads/ad_objects/ad_study.rb +104 -0
  70. data/lib/facebook_ads/ad_objects/ad_study_ads_asset_user_permissions.rb +46 -0
  71. data/lib/facebook_ads/ad_objects/ad_study_cell.rb +59 -0
  72. data/lib/facebook_ads/ad_objects/ad_study_objective.rb +58 -0
  73. data/lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb +50 -0
  74. data/lib/facebook_ads/ad_objects/adgroup_relevance_score.rb +40 -0
  75. data/lib/facebook_ads/ad_objects/adgroup_review_feedback.rb +38 -0
  76. data/lib/facebook_ads/ad_objects/ads_action_stats.rb +55 -0
  77. data/lib/facebook_ads/ad_objects/ads_data_partner.rb +37 -0
  78. data/lib/facebook_ads/ad_objects/ads_image_crops.rb +43 -0
  79. data/lib/facebook_ads/ad_objects/ads_insights.rb +224 -0
  80. data/lib/facebook_ads/ad_objects/ads_pixel.rb +76 -0
  81. data/lib/facebook_ads/ad_objects/ads_pixel_stats.rb +40 -0
  82. data/lib/facebook_ads/ad_objects/ads_pixel_stats_result.rb +51 -0
  83. data/lib/facebook_ads/ad_objects/agency_client_declaration.rb +48 -0
  84. data/lib/facebook_ads/ad_objects/album.rb +102 -0
  85. data/lib/facebook_ads/ad_objects/android_app_link.rb +40 -0
  86. data/lib/facebook_ads/ad_objects/app_links.rb +43 -0
  87. data/lib/facebook_ads/ad_objects/assigned_user.rb +38 -0
  88. data/lib/facebook_ads/ad_objects/attribution_spec.rb +38 -0
  89. data/lib/facebook_ads/ad_objects/audience_permission.rb +39 -0
  90. data/lib/facebook_ads/ad_objects/audio_copyright.rb +46 -0
  91. data/lib/facebook_ads/ad_objects/broad_targeting_categories.rb +46 -0
  92. data/lib/facebook_ads/ad_objects/business.rb +523 -0
  93. data/lib/facebook_ads/ad_objects/business_activity_log_event.rb +55 -0
  94. data/lib/facebook_ads/ad_objects/business_ad_account_request.rb +37 -0
  95. data/lib/facebook_ads/ad_objects/business_advertisable_applications_result.rb +38 -0
  96. data/lib/facebook_ads/ad_objects/business_application_request.rb +37 -0
  97. data/lib/facebook_ads/ad_objects/business_matched_search_applications_edge_data.rb +58 -0
  98. data/lib/facebook_ads/ad_objects/business_page_request.rb +37 -0
  99. data/lib/facebook_ads/ad_objects/business_project.rb +45 -0
  100. data/lib/facebook_ads/ad_objects/business_role_request.rb +61 -0
  101. data/lib/facebook_ads/ad_objects/business_user.rb +52 -0
  102. data/lib/facebook_ads/ad_objects/campaign.rb +233 -0
  103. data/lib/facebook_ads/ad_objects/canvas.rb +52 -0
  104. data/lib/facebook_ads/ad_objects/canvas_body_element.rb +37 -0
  105. data/lib/facebook_ads/ad_objects/check_batch_request_status.rb +40 -0
  106. data/lib/facebook_ads/ad_objects/conversion_action_query.rb +62 -0
  107. data/lib/facebook_ads/ad_objects/copyright_attribution_insights.rb +41 -0
  108. data/lib/facebook_ads/ad_objects/cover_photo.rb +40 -0
  109. data/lib/facebook_ads/ad_objects/custom_audience.rb +174 -0
  110. data/lib/facebook_ads/ad_objects/custom_audience_ad_account.rb +36 -0
  111. data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb +104 -0
  112. data/lib/facebook_ads/ad_objects/custom_audience_permission.rb +41 -0
  113. data/lib/facebook_ads/ad_objects/custom_audience_prefill_state.rb +39 -0
  114. data/lib/facebook_ads/ad_objects/custom_audience_session.rb +44 -0
  115. data/lib/facebook_ads/ad_objects/custom_audience_status.rb +38 -0
  116. data/lib/facebook_ads/ad_objects/custom_audiences_tos.rb +38 -0
  117. data/lib/facebook_ads/ad_objects/custom_conversion.rb +109 -0
  118. data/lib/facebook_ads/ad_objects/custom_conversion_stats_result.rb +50 -0
  119. data/lib/facebook_ads/ad_objects/day_part.rb +40 -0
  120. data/lib/facebook_ads/ad_objects/delivery_check.rb +40 -0
  121. data/lib/facebook_ads/ad_objects/delivery_check_extra_info.rb +39 -0
  122. data/lib/facebook_ads/ad_objects/direct_deal.rb +66 -0
  123. data/lib/facebook_ads/ad_objects/direct_debit.rb +45 -0
  124. data/lib/facebook_ads/ad_objects/domain.rb +37 -0
  125. data/lib/facebook_ads/ad_objects/engagement.rb +43 -0
  126. data/lib/facebook_ads/ad_objects/ent_with_sponsor.rb +39 -0
  127. data/lib/facebook_ads/ad_objects/event.rb +190 -0
  128. data/lib/facebook_ads/ad_objects/event_source_group.rb +53 -0
  129. data/lib/facebook_ads/ad_objects/extended_credit.rb +70 -0
  130. data/lib/facebook_ads/ad_objects/extended_credit_allocation_config.rb +61 -0
  131. data/lib/facebook_ads/ad_objects/extended_credit_invoice_group.rb +43 -0
  132. data/lib/facebook_ads/ad_objects/external_event_source.rb +38 -0
  133. data/lib/facebook_ads/ad_objects/flexible_targeting.rb +64 -0
  134. data/lib/facebook_ads/ad_objects/funding_source_details.rb +39 -0
  135. data/lib/facebook_ads/ad_objects/funding_source_details_coupon.rb +40 -0
  136. data/lib/facebook_ads/ad_objects/helpers/custom_audience_helpers.rb +170 -0
  137. data/lib/facebook_ads/ad_objects/hotel_room.rb +43 -0
  138. data/lib/facebook_ads/ad_objects/id_name.rb +37 -0
  139. data/lib/facebook_ads/ad_objects/insights_result.rb +73 -0
  140. data/lib/facebook_ads/ad_objects/instagram_insights_result.rb +67 -0
  141. data/lib/facebook_ads/ad_objects/instagram_insights_value.rb +38 -0
  142. data/lib/facebook_ads/ad_objects/instant_article.rb +47 -0
  143. data/lib/facebook_ads/ad_objects/instant_article_insights_query_result.rb +61 -0
  144. data/lib/facebook_ads/ad_objects/ios_app_link.rb +39 -0
  145. data/lib/facebook_ads/ad_objects/lead.rb +47 -0
  146. data/lib/facebook_ads/ad_objects/lead_gen_conditional_questions_group.rb +37 -0
  147. data/lib/facebook_ads/ad_objects/lead_gen_data_draft.rb +94 -0
  148. data/lib/facebook_ads/ad_objects/lead_gen_draft_question.rb +44 -0
  149. data/lib/facebook_ads/ad_objects/lead_gen_form_preview_details.rb +47 -0
  150. data/lib/facebook_ads/ad_objects/lead_gen_legal_content.rb +43 -0
  151. data/lib/facebook_ads/ad_objects/lead_gen_qualifier.rb +40 -0
  152. data/lib/facebook_ads/ad_objects/lead_gen_question.rb +43 -0
  153. data/lib/facebook_ads/ad_objects/lead_gen_question_option.rb +38 -0
  154. data/lib/facebook_ads/ad_objects/leadgen_form.rb +118 -0
  155. data/lib/facebook_ads/ad_objects/legacy_business_ad_account_request.rb +38 -0
  156. data/lib/facebook_ads/ad_objects/life_event.rb +54 -0
  157. data/lib/facebook_ads/ad_objects/live_video.rb +100 -0
  158. data/lib/facebook_ads/ad_objects/location.rb +49 -0
  159. data/lib/facebook_ads/ad_objects/lookalike_spec.rb +43 -0
  160. data/lib/facebook_ads/ad_objects/mailing_address.rb +42 -0
  161. data/lib/facebook_ads/ad_objects/measurement_report.rb +47 -0
  162. data/lib/facebook_ads/ad_objects/media_fingerprint.rb +47 -0
  163. data/lib/facebook_ads/ad_objects/messaging_feature_review.rb +38 -0
  164. data/lib/facebook_ads/ad_objects/messenger_profile.rb +55 -0
  165. data/lib/facebook_ads/ad_objects/minimum_budget.rb +41 -0
  166. data/lib/facebook_ads/ad_objects/native_offer.rb +113 -0
  167. data/lib/facebook_ads/ad_objects/offline_conversion_data_set.rb +137 -0
  168. data/lib/facebook_ads/ad_objects/offline_terms_of_service.rb +37 -0
  169. data/lib/facebook_ads/ad_objects/offsite_pixel.rb +57 -0
  170. data/lib/facebook_ads/ad_objects/open_graph_context.rb +35 -0
  171. data/lib/facebook_ads/ad_objects/open_graph_rating.rb +43 -0
  172. data/lib/facebook_ads/ad_objects/oracle_transaction.rb +51 -0
  173. data/lib/facebook_ads/ad_objects/outcome_prediction_point.rb +40 -0
  174. data/lib/facebook_ads/ad_objects/owned_domain.rb +37 -0
  175. data/lib/facebook_ads/ad_objects/page.rb +1231 -0
  176. data/lib/facebook_ads/ad_objects/page_admin_note.rb +37 -0
  177. data/lib/facebook_ads/ad_objects/page_call_to_action.rb +104 -0
  178. data/lib/facebook_ads/ad_objects/page_category.rb +39 -0
  179. data/lib/facebook_ads/ad_objects/page_change_proposal.rb +39 -0
  180. data/lib/facebook_ads/ad_objects/page_insights_async_export_run.rb +43 -0
  181. data/lib/facebook_ads/ad_objects/page_label.rb +47 -0
  182. data/lib/facebook_ads/ad_objects/page_parking.rb +39 -0
  183. data/lib/facebook_ads/ad_objects/page_payment_options.rb +41 -0
  184. data/lib/facebook_ads/ad_objects/page_post.rb +159 -0
  185. data/lib/facebook_ads/ad_objects/page_restaurant_services.rb +46 -0
  186. data/lib/facebook_ads/ad_objects/page_restaurant_specialties.rb +41 -0
  187. data/lib/facebook_ads/ad_objects/page_saved_filter.rb +134 -0
  188. data/lib/facebook_ads/ad_objects/page_settings.rb +38 -0
  189. data/lib/facebook_ads/ad_objects/page_start_info.rb +38 -0
  190. data/lib/facebook_ads/ad_objects/page_upcoming_change.rb +39 -0
  191. data/lib/facebook_ads/ad_objects/page_videos_you_can_use.rb +38 -0
  192. data/lib/facebook_ads/ad_objects/partner_category.rb +51 -0
  193. data/lib/facebook_ads/ad_objects/partner_integration_linked.rb +42 -0
  194. data/lib/facebook_ads/ad_objects/persona.rb +37 -0
  195. data/lib/facebook_ads/ad_objects/photo.rb +102 -0
  196. data/lib/facebook_ads/ad_objects/place_topic.rb +49 -0
  197. data/lib/facebook_ads/ad_objects/product_catalog.rb +335 -0
  198. data/lib/facebook_ads/ad_objects/product_catalog_hotel_rooms_batch.rb +50 -0
  199. data/lib/facebook_ads/ad_objects/product_catalog_image_settings.rb +38 -0
  200. data/lib/facebook_ads/ad_objects/product_catalog_image_settings_operation.rb +37 -0
  201. data/lib/facebook_ads/ad_objects/product_catalog_pricing_variables_batch.rb +50 -0
  202. data/lib/facebook_ads/ad_objects/product_catalog_product_sets_batch.rb +40 -0
  203. data/lib/facebook_ads/ad_objects/product_da_event_samples_batch.rb +54 -0
  204. data/lib/facebook_ads/ad_objects/product_event_stat.rb +74 -0
  205. data/lib/facebook_ads/ad_objects/product_feed.rb +126 -0
  206. data/lib/facebook_ads/ad_objects/product_feed_schedule.rb +62 -0
  207. data/lib/facebook_ads/ad_objects/product_feed_upload.rb +57 -0
  208. data/lib/facebook_ads/ad_objects/product_feed_upload_error.rb +49 -0
  209. data/lib/facebook_ads/ad_objects/product_group.rb +98 -0
  210. data/lib/facebook_ads/ad_objects/product_item.rb +155 -0
  211. data/lib/facebook_ads/ad_objects/product_item_commerce_insights.rb +39 -0
  212. data/lib/facebook_ads/ad_objects/product_set.rb +52 -0
  213. data/lib/facebook_ads/ad_objects/product_variant.rb +39 -0
  214. data/lib/facebook_ads/ad_objects/products_quality_issue.rb +42 -0
  215. data/lib/facebook_ads/ad_objects/profile.rb +62 -0
  216. data/lib/facebook_ads/ad_objects/profile_picture_source.rb +53 -0
  217. data/lib/facebook_ads/ad_objects/publisher_space.rb +37 -0
  218. data/lib/facebook_ads/ad_objects/reach_estimate.rb +39 -0
  219. data/lib/facebook_ads/ad_objects/reach_frequency_prediction.rb +101 -0
  220. data/lib/facebook_ads/ad_objects/reach_frequency_spec.rb +43 -0
  221. data/lib/facebook_ads/ad_objects/rev_share_policy.rb +38 -0
  222. data/lib/facebook_ads/ad_objects/rtb_dynamic_post.rb +44 -0
  223. data/lib/facebook_ads/ad_objects/saved_message_response.rb +49 -0
  224. data/lib/facebook_ads/ad_objects/screen_name.rb +39 -0
  225. data/lib/facebook_ads/ad_objects/shadow_ig_comment.rb +47 -0
  226. data/lib/facebook_ads/ad_objects/shadow_ig_media.rb +61 -0
  227. data/lib/facebook_ads/ad_objects/shadow_ig_user.rb +74 -0
  228. data/lib/facebook_ads/ad_objects/system_user.rb +48 -0
  229. data/lib/facebook_ads/ad_objects/tab.rb +45 -0
  230. data/lib/facebook_ads/ad_objects/targeting.rb +134 -0
  231. data/lib/facebook_ads/ad_objects/targeting_dynamic_rule.rb +44 -0
  232. data/lib/facebook_ads/ad_objects/targeting_geo_location.rb +47 -0
  233. data/lib/facebook_ads/ad_objects/targeting_geo_location_city.rb +43 -0
  234. data/lib/facebook_ads/ad_objects/targeting_geo_location_custom_location.rb +50 -0
  235. data/lib/facebook_ads/ad_objects/targeting_geo_location_electoral_district.rb +40 -0
  236. data/lib/facebook_ads/ad_objects/targeting_geo_location_market.rb +40 -0
  237. data/lib/facebook_ads/ad_objects/targeting_geo_location_place.rb +45 -0
  238. data/lib/facebook_ads/ad_objects/targeting_geo_location_political_district.rb +40 -0
  239. data/lib/facebook_ads/ad_objects/targeting_geo_location_region.rb +39 -0
  240. data/lib/facebook_ads/ad_objects/targeting_geo_location_zip.rb +41 -0
  241. data/lib/facebook_ads/ad_objects/targeting_product_audience_spec.rb +39 -0
  242. data/lib/facebook_ads/ad_objects/targeting_product_audience_sub_spec.rb +38 -0
  243. data/lib/facebook_ads/ad_objects/targeting_sentence_line.rb +38 -0
  244. data/lib/facebook_ads/ad_objects/transaction.rb +51 -0
  245. data/lib/facebook_ads/ad_objects/transaction_currency_amount.rb +39 -0
  246. data/lib/facebook_ads/ad_objects/unified_thread.rb +49 -0
  247. data/lib/facebook_ads/ad_objects/url.rb +41 -0
  248. data/lib/facebook_ads/ad_objects/user.rb +268 -0
  249. data/lib/facebook_ads/ad_objects/user_lead_gen_disclaimer_response.rb +38 -0
  250. data/lib/facebook_ads/ad_objects/user_lead_gen_field_data.rb +38 -0
  251. data/lib/facebook_ads/ad_objects/video_copyright.rb +58 -0
  252. data/lib/facebook_ads/ad_objects/video_copyright_rule.rb +46 -0
  253. data/lib/facebook_ads/ad_objects/video_list.rb +52 -0
  254. data/lib/facebook_ads/ad_objects/video_thumbnail.rb +42 -0
  255. data/lib/facebook_ads/ad_objects/voip_info.rb +43 -0
  256. data/lib/facebook_ads/ad_objects/web_app_link.rb +38 -0
  257. data/lib/facebook_ads/ad_objects/windows_app_link.rb +40 -0
  258. data/lib/facebook_ads/ad_objects/windows_phone_app_link.rb +39 -0
  259. data/lib/facebook_ads/api_request.rb +123 -0
  260. data/lib/facebook_ads/api_response.rb +47 -0
  261. data/lib/facebook_ads/batch_api/batch.rb +86 -0
  262. data/lib/facebook_ads/batch_api/batch_proxy.rb +67 -0
  263. data/lib/facebook_ads/config.rb +43 -0
  264. data/lib/facebook_ads/edge.rb +184 -0
  265. data/lib/facebook_ads/errors.rb +55 -0
  266. data/lib/facebook_ads/field_types.rb +65 -0
  267. data/lib/facebook_ads/field_types/ad_object.rb +37 -0
  268. data/lib/facebook_ads/field_types/base.rb +33 -0
  269. data/lib/facebook_ads/field_types/boolean.rb +25 -0
  270. data/lib/facebook_ads/field_types/datetime.rb +47 -0
  271. data/lib/facebook_ads/field_types/double.rb +29 -0
  272. data/lib/facebook_ads/field_types/enum.rb +31 -0
  273. data/lib/facebook_ads/field_types/integer.rb +33 -0
  274. data/lib/facebook_ads/field_types/list.rb +57 -0
  275. data/lib/facebook_ads/field_types/object.rb +45 -0
  276. data/lib/facebook_ads/field_types/string_type.rb +39 -0
  277. data/lib/facebook_ads/field_types/upload_file.rb +121 -0
  278. data/lib/facebook_ads/fields.rb +66 -0
  279. data/lib/facebook_ads/helpers/edge_helpers.rb +57 -0
  280. data/lib/facebook_ads/helpers/node_helpers.rb +80 -0
  281. data/lib/facebook_ads/helpers/shortcuts.rb +34 -0
  282. data/lib/facebook_ads/param_set.rb +74 -0
  283. data/lib/facebook_ads/ruby2patch.rb +27 -0
  284. data/lib/facebook_ads/session.rb +99 -0
  285. data/lib/facebook_ads/test.rb +23 -0
  286. data/lib/facebook_ads/test/base.rb +98 -0
  287. data/lib/facebook_ads/test/config.rb +55 -0
  288. data/lib/facebook_ads/test/errors.rb +23 -0
  289. data/lib/facebook_ads/test/exit_codes.rb +29 -0
  290. data/lib/facebook_ads/test/exit_hook.rb +35 -0
  291. data/lib/facebook_ads/test/fixtures.rb +107 -0
  292. data/lib/facebook_ads/utils/utils.rb +29 -0
  293. data/lib/facebook_ads/version.rb +24 -0
  294. data/lib/facebook_ads/videos/video_io.rb +25 -0
  295. data/lib/facebook_ads/videos/video_request.rb +42 -0
  296. data/lib/facebookbusiness.rb +1 -0
  297. metadata +508 -0
@@ -0,0 +1,55 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class MessengerProfile < AdObject
29
+ FIELDS = [
30
+ "GET_STARTED",
31
+ "PERSISTENT_MENU",
32
+ "TARGET_AUDIENCE",
33
+ "WHITELISTED_DOMAINS",
34
+ "GREETING",
35
+ "ACCOUNT_LINKING_URL",
36
+ "PAYMENT_SETTINGS",
37
+ "HOME_URL",
38
+ ]
39
+
40
+
41
+ field :account_linking_url, 'string'
42
+ field :get_started, 'object'
43
+ field :greeting, { list: 'object' }
44
+ field :home_url, 'object'
45
+ field :payment_settings, 'object'
46
+ field :persistent_menu, { list: 'object' }
47
+ field :target_audience, 'object'
48
+ field :whitelisted_domains, { list: 'string' }
49
+ has_no_id
50
+ has_no_get
51
+ has_no_post
52
+ has_no_delete
53
+
54
+ end
55
+ end
@@ -0,0 +1,41 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class MinimumBudget < AdObject
29
+
30
+ field :currency, 'string'
31
+ field :min_daily_budget_high_freq, 'int'
32
+ field :min_daily_budget_imp, 'int'
33
+ field :min_daily_budget_low_freq, 'int'
34
+ field :min_daily_budget_video_views, 'int'
35
+ has_no_id
36
+ has_no_get
37
+ has_no_post
38
+ has_no_delete
39
+
40
+ end
41
+ end
@@ -0,0 +1,113 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class NativeOffer < AdObject
29
+ UNIQUE_CODES_FILE_CODE_TYPE = [
30
+ "discount_codes",
31
+ "barcodes",
32
+ "online_discount_codes",
33
+ "instore_discount_codes",
34
+ "instore_barcodes",
35
+ "discount_and_barcodes",
36
+ "discount_and_discount",
37
+ ]
38
+
39
+ BARCODE_TYPE = [
40
+ "CODE128",
41
+ "CODE128B",
42
+ "CODE93",
43
+ "DATABAR",
44
+ "DATABAR_EXPANDED",
45
+ "DATABAR_EXPANDED_STACKED",
46
+ "DATABAR_LIMITED",
47
+ "DATAMATRIX",
48
+ "EAN",
49
+ "PDF417",
50
+ "QR",
51
+ "UPC_A",
52
+ "UPC_E",
53
+ ]
54
+
55
+ LOCATION_TYPE = [
56
+ "online",
57
+ "offline",
58
+ "both",
59
+ ]
60
+
61
+
62
+ field :barcode_photo, 'string'
63
+ field :barcode_photo_uri, 'string'
64
+ field :barcode_type, 'string'
65
+ field :barcode_value, 'string'
66
+ field :details, 'string'
67
+ field :disable_location, 'bool'
68
+ field :discounts, { list: 'object' }
69
+ field :expiration_time, 'datetime'
70
+ field :id, 'string'
71
+ field :instore_code, 'string'
72
+ field :location_type, 'string'
73
+ field :max_save_count, 'int'
74
+ field :online_code, 'string'
75
+ field :page, 'Page'
76
+ field :page_set_id, 'string'
77
+ field :redemption_link, 'string'
78
+ field :save_count, 'int'
79
+ field :terms, 'string'
80
+ field :title, 'string'
81
+ field :total_unique_codes, 'string'
82
+ field :unique_codes, 'string'
83
+ field :unique_codes_file_code_type, 'string'
84
+ field :unique_codes_file_name, 'string'
85
+ field :unique_codes_file_upload_status, 'string'
86
+ has_no_post
87
+ has_no_delete
88
+
89
+ has_edge :codes do |edge|
90
+ edge.post 'NativeOffer' do |api|
91
+ api.has_param :file, 'file'
92
+ api.has_param :unique_codes_file_code_type, { enum: -> { NativeOffer::UNIQUE_CODES_FILE_CODE_TYPE }}
93
+ end
94
+ end
95
+
96
+ has_edge :nativeofferviews do |edge|
97
+ edge.post 'NativeOffer' do |api|
98
+ api.has_param :ad_account, 'string'
99
+ api.has_param :ad_image_hashes, { list: 'string' }
100
+ api.has_param :carousel_captions, { list: 'string' }
101
+ api.has_param :carousel_links, { list: 'string' }
102
+ api.has_param :image_crops, { list: 'hash' }
103
+ api.has_param :message, 'string'
104
+ api.has_param :photos, { list: 'string' }
105
+ api.has_param :published, 'bool'
106
+ api.has_param :published_ads, 'bool'
107
+ api.has_param :urls, { list: 'string' }
108
+ api.has_param :videos, { list: 'string' }
109
+ end
110
+ end
111
+
112
+ end
113
+ end
@@ -0,0 +1,137 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class OfflineConversionDataSet < AdObject
29
+
30
+ field :business, 'Business'
31
+ field :config, 'string'
32
+ field :creation_time, 'datetime'
33
+ field :description, 'string'
34
+ field :duplicate_entries, 'int'
35
+ field :enable_auto_assign_to_accounts, 'bool'
36
+ field :event_stats, 'string'
37
+ field :event_time_max, 'int'
38
+ field :event_time_min, 'int'
39
+ field :id, 'string'
40
+ field :is_restricted_use, 'bool'
41
+ field :last_upload_app, 'string'
42
+ field :matched_entries, 'int'
43
+ field :name, 'string'
44
+ field :usage, 'object'
45
+ field :valid_entries, 'int'
46
+ field :auto_assign_to_new_accounts_only, 'bool'
47
+
48
+ has_edge :activities do |edge|
49
+ edge.get do |api|
50
+ api.has_param :business_id, 'string'
51
+ api.has_param :end_time, 'datetime'
52
+ 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 }}
53
+ api.has_param :start_time, 'datetime'
54
+ end
55
+ end
56
+
57
+ has_edge :adaccounts do |edge|
58
+ edge.delete do |api|
59
+ api.has_param :account_id, 'string'
60
+ api.has_param :business, 'string'
61
+ end
62
+ edge.get 'AdAccount' do |api|
63
+ api.has_param :business, 'string'
64
+ end
65
+ edge.post do |api|
66
+ api.has_param :account_id, 'string'
67
+ api.has_param :auto_track_for_ads, 'bool'
68
+ api.has_param :business, 'string'
69
+ end
70
+ end
71
+
72
+ has_edge :agencies do |edge|
73
+ edge.delete do |api|
74
+ api.has_param :business, 'string'
75
+ end
76
+ edge.post 'Business' do |api|
77
+ api.has_param :business, 'string'
78
+ api.has_param :permitted_roles, { list: { enum: -> { Business::PERMITTED_ROLES }} }
79
+ end
80
+ end
81
+
82
+ has_edge :events do |edge|
83
+ edge.post do |api|
84
+ api.has_param :data, { list: 'object' }
85
+ api.has_param :namespace_id, 'string'
86
+ api.has_param :progress, 'object'
87
+ api.has_param :upload_id, 'string'
88
+ api.has_param :upload_tag, 'string'
89
+ end
90
+ end
91
+
92
+ has_edge :stats do |edge|
93
+ edge.get do |api|
94
+ api.has_param :aggr_time, { enum: %w{upload_time event_time }}
95
+ api.has_param :end, 'int'
96
+ api.has_param :granularity, { enum: %w{daily hourly }}
97
+ api.has_param :skip_empty_values, 'bool'
98
+ api.has_param :start, 'int'
99
+ api.has_param :user_timezone_id, 'int'
100
+ end
101
+ end
102
+
103
+ has_edge :uploads do |edge|
104
+ edge.get do |api|
105
+ api.has_param :end_time, 'object'
106
+ api.has_param :order, { enum: %w{ASCENDING DESCENDING }}
107
+ 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 }}
108
+ api.has_param :start_time, 'object'
109
+ api.has_param :upload_tag, 'string'
110
+ end
111
+ edge.post do |api|
112
+ api.has_param :upload_tag, 'string'
113
+ end
114
+ end
115
+
116
+ has_edge :userpermissions do |edge|
117
+ edge.delete do |api|
118
+ api.has_param :business, 'object'
119
+ api.has_param :email, 'string'
120
+ api.has_param :user, 'int'
121
+ end
122
+ edge.post do |api|
123
+ api.has_param :business, 'object'
124
+ api.has_param :role, { enum: %w{ADMIN UPLOADER ADVERTISER }}
125
+ api.has_param :user, 'int'
126
+ end
127
+ end
128
+
129
+ has_edge :validate do |edge|
130
+ edge.post 'OfflineConversionDataSet' do |api|
131
+ api.has_param :data, { list: 'object' }
132
+ api.has_param :namespace_id, 'string'
133
+ end
134
+ end
135
+
136
+ end
137
+ end
@@ -0,0 +1,37 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class OfflineTermsOfService < AdObject
29
+
30
+ field :accept_time, 'int'
31
+ field :id, 'string'
32
+ field :signed_by_user, 'User'
33
+ has_no_post
34
+ has_no_delete
35
+
36
+ end
37
+ end
@@ -0,0 +1,57 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class OffsitePixel < AdObject
29
+ TAG = [
30
+ "CHECKOUT",
31
+ "REGISTRATION",
32
+ "LEAD",
33
+ "KEY_PAGE_VIEW",
34
+ "ADD_TO_CART",
35
+ "OTHER",
36
+ ]
37
+
38
+
39
+ field :creator, 'string'
40
+ field :id, 'string'
41
+ field :js_pixel, 'string'
42
+ field :last_firing_time, 'datetime'
43
+ field :name, 'string'
44
+ field :tag, 'string'
45
+
46
+ has_edge :adaccounts do |edge|
47
+ edge.delete do |api|
48
+ api.has_param :adaccounts, { list: 'string' }
49
+ end
50
+ edge.get 'AdAccount'
51
+ edge.post 'AdAccount' do |api|
52
+ api.has_param :adaccounts, { list: 'string' }
53
+ end
54
+ end
55
+
56
+ end
57
+ end
@@ -0,0 +1,35 @@
1
+ # Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
2
+ #
3
+ # You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
4
+ # copy, modify, and distribute this software in source code or binary form for use
5
+ # in connection with the web services and APIs provided by Facebook.
6
+ #
7
+ # As with any software that integrates with the Facebook platform, your use of
8
+ # this software is subject to the Facebook Platform Policy
9
+ # [http://developers.facebook.com/policy/]. This copyright notice shall be
10
+ # included in all copies or substantial portions of the software.
11
+ #
12
+ # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
13
+ # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
14
+ # FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
15
+ # COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
16
+ # IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
17
+ # CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
18
+
19
+ # FB:AUTOGEN
20
+
21
+ module FacebookAds
22
+ # This class is auto-generated.
23
+
24
+ # For any issues or feature requests related to this class, please let us know
25
+ # on github and we'll fix in our codegen framework. We'll not be able to accept
26
+ # pull request for this class.
27
+
28
+ class OpenGraphContext < AdObject
29
+
30
+ field :id, 'string'
31
+ has_no_post
32
+ has_no_delete
33
+
34
+ end
35
+ end