bonio-facebookbusiness 0.13.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (477) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE.txt +17 -0
  3. data/README.md +262 -0
  4. data/lib/bonio-facebookbusiness.rb +19 -0
  5. data/lib/facebook_ads/ad_object.rb +177 -0
  6. data/lib/facebook_ads/ad_objects/ad.rb +255 -0
  7. data/lib/facebook_ads/ad_objects/ad_account.rb +1118 -0
  8. data/lib/facebook_ads/ad_objects/ad_account_activity.rb +63 -0
  9. data/lib/facebook_ads/ad_objects/ad_account_ad_rules_history.rb +64 -0
  10. data/lib/facebook_ads/ad_objects/ad_account_ad_volume.rb +69 -0
  11. data/lib/facebook_ads/ad_objects/ad_account_default_destination.rb +38 -0
  12. data/lib/facebook_ads/ad_objects/ad_account_default_objective.rb +80 -0
  13. data/lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb +67 -0
  14. data/lib/facebook_ads/ad_objects/ad_account_ios_fourteen_campaign_limits.rb +39 -0
  15. data/lib/facebook_ads/ad_objects/ad_account_matched_search_applications_edge_data.rb +70 -0
  16. data/lib/facebook_ads/ad_objects/ad_account_max_bid.rb +37 -0
  17. data/lib/facebook_ads/ad_objects/ad_account_promotable_objects.rb +39 -0
  18. data/lib/facebook_ads/ad_objects/ad_account_reach_estimate.rb +39 -0
  19. data/lib/facebook_ads/ad_objects/ad_account_recommended_camapaign_budget.rb +39 -0
  20. data/lib/facebook_ads/ad_objects/ad_account_subscribed_apps.rb +38 -0
  21. data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb +271 -0
  22. data/lib/facebook_ads/ad_objects/ad_account_tracking_data.rb +37 -0
  23. data/lib/facebook_ads/ad_objects/ad_account_user.rb +38 -0
  24. data/lib/facebook_ads/ad_objects/ad_activity.rb +148 -0
  25. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb +124 -0
  26. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_asset_label.rb +37 -0
  27. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_body.rb +39 -0
  28. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_caption.rb +39 -0
  29. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_description.rb +39 -0
  30. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_group_rule.rb +43 -0
  31. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_image.rb +41 -0
  32. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_link_url.rb +42 -0
  33. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_title.rb +39 -0
  34. data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_video.rb +42 -0
  35. data/lib/facebook_ads/ad_objects/ad_async_request.rb +58 -0
  36. data/lib/facebook_ads/ad_objects/ad_async_request_set.rb +60 -0
  37. data/lib/facebook_ads/ad_objects/ad_async_request_set_notification_result.rb +38 -0
  38. data/lib/facebook_ads/ad_objects/ad_bid_adjustments.rb +39 -0
  39. data/lib/facebook_ads/ad_objects/ad_campaign_activity.rb +182 -0
  40. data/lib/facebook_ads/ad_objects/ad_campaign_bid_constraint.rb +37 -0
  41. data/lib/facebook_ads/ad_objects/ad_campaign_delivery_estimate.rb +67 -0
  42. data/lib/facebook_ads/ad_objects/ad_campaign_delivery_stats_unsupported_reasons.rb +38 -0
  43. data/lib/facebook_ads/ad_objects/ad_campaign_frequency_control_specs.rb +39 -0
  44. data/lib/facebook_ads/ad_objects/ad_campaign_group_activity.rb +99 -0
  45. data/lib/facebook_ads/ad_objects/ad_campaign_issues_info.rb +41 -0
  46. data/lib/facebook_ads/ad_objects/ad_campaign_learning_stage_info.rb +40 -0
  47. data/lib/facebook_ads/ad_objects/ad_campaign_optimization_event.rb +39 -0
  48. data/lib/facebook_ads/ad_objects/ad_campaign_paced_bid_info.rb +37 -0
  49. data/lib/facebook_ads/ad_objects/ad_creative.rb +257 -0
  50. data/lib/facebook_ads/ad_objects/ad_creative_ad_disclaimer.rb +39 -0
  51. data/lib/facebook_ads/ad_objects/ad_creative_collection_thumbnail_info.rb +39 -0
  52. data/lib/facebook_ads/ad_objects/ad_creative_insights.rb +37 -0
  53. data/lib/facebook_ads/ad_objects/ad_creative_interactive_components_spec.rb +38 -0
  54. data/lib/facebook_ads/ad_objects/ad_creative_link_data.rb +82 -0
  55. data/lib/facebook_ads/ad_objects/ad_creative_link_data_app_link_spec.rb +40 -0
  56. data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb +108 -0
  57. data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action_value.rb +47 -0
  58. data/lib/facebook_ads/ad_objects/ad_creative_link_data_child_attachment.rb +47 -0
  59. data/lib/facebook_ads/ad_objects/ad_creative_link_data_image_layer_spec.rb +101 -0
  60. data/lib/facebook_ads/ad_objects/ad_creative_link_data_image_overlay_spec.rb +106 -0
  61. data/lib/facebook_ads/ad_objects/ad_creative_link_data_sponsorship_info_spec.rb +38 -0
  62. data/lib/facebook_ads/ad_objects/ad_creative_link_data_template_video_spec.rb +39 -0
  63. data/lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb +43 -0
  64. data/lib/facebook_ads/ad_objects/ad_creative_omnichannel_link_spec.rb +38 -0
  65. data/lib/facebook_ads/ad_objects/ad_creative_photo_data.rb +42 -0
  66. data/lib/facebook_ads/ad_objects/ad_creative_photo_data_media_elements.rb +40 -0
  67. data/lib/facebook_ads/ad_objects/ad_creative_place_data.rb +42 -0
  68. data/lib/facebook_ads/ad_objects/ad_creative_platform_customization.rb +37 -0
  69. data/lib/facebook_ads/ad_objects/ad_creative_portrait_customizations.rb +38 -0
  70. data/lib/facebook_ads/ad_objects/ad_creative_post_click_configuration.rb +38 -0
  71. data/lib/facebook_ads/ad_objects/ad_creative_recommender_settings.rb +38 -0
  72. data/lib/facebook_ads/ad_objects/ad_creative_static_fallback_spec.rb +42 -0
  73. data/lib/facebook_ads/ad_objects/ad_creative_template_url_spec.rb +43 -0
  74. data/lib/facebook_ads/ad_objects/ad_creative_text_data.rb +37 -0
  75. data/lib/facebook_ads/ad_objects/ad_creative_video_data.rb +53 -0
  76. data/lib/facebook_ads/ad_objects/ad_customization_rule_spec.rb +46 -0
  77. data/lib/facebook_ads/ad_objects/ad_dynamic_creative.rb +37 -0
  78. data/lib/facebook_ads/ad_objects/ad_entity_target_spend.rb +41 -0
  79. data/lib/facebook_ads/ad_objects/ad_image.rb +58 -0
  80. data/lib/facebook_ads/ad_objects/ad_keywords.rb +40 -0
  81. data/lib/facebook_ads/ad_objects/ad_label.rb +53 -0
  82. data/lib/facebook_ads/ad_objects/ad_monetization_property.rb +66 -0
  83. data/lib/facebook_ads/ad_objects/ad_network_analytics_async_query_result.rb +41 -0
  84. data/lib/facebook_ads/ad_objects/ad_network_analytics_sync_query_result.rb +102 -0
  85. data/lib/facebook_ads/ad_objects/ad_place_page_set.rb +52 -0
  86. data/lib/facebook_ads/ad_objects/ad_place_page_set_metadata.rb +40 -0
  87. data/lib/facebook_ads/ad_objects/ad_placement.rb +42 -0
  88. data/lib/facebook_ads/ad_objects/ad_preview.rb +88 -0
  89. data/lib/facebook_ads/ad_objects/ad_promoted_object.rb +86 -0
  90. data/lib/facebook_ads/ad_objects/ad_recommendation.rb +55 -0
  91. data/lib/facebook_ads/ad_objects/ad_recommendation_data.rb +37 -0
  92. data/lib/facebook_ads/ad_objects/ad_report_run.rb +72 -0
  93. data/lib/facebook_ads/ad_objects/ad_rule.rb +92 -0
  94. data/lib/facebook_ads/ad_objects/ad_rule_evaluation_spec.rb +43 -0
  95. data/lib/facebook_ads/ad_objects/ad_rule_execution_options.rb +44 -0
  96. data/lib/facebook_ads/ad_objects/ad_rule_execution_spec.rb +56 -0
  97. data/lib/facebook_ads/ad_objects/ad_rule_filters.rb +55 -0
  98. data/lib/facebook_ads/ad_objects/ad_rule_history.rb +58 -0
  99. data/lib/facebook_ads/ad_objects/ad_rule_history_result.rb +45 -0
  100. data/lib/facebook_ads/ad_objects/ad_rule_history_result_action.rb +40 -0
  101. data/lib/facebook_ads/ad_objects/ad_rule_schedule.rb +39 -0
  102. data/lib/facebook_ads/ad_objects/ad_rule_schedule_spec.rb +38 -0
  103. data/lib/facebook_ads/ad_objects/ad_rule_trigger.rb +64 -0
  104. data/lib/facebook_ads/ad_objects/ad_set.rb +380 -0
  105. data/lib/facebook_ads/ad_objects/ad_study.rb +74 -0
  106. data/lib/facebook_ads/ad_objects/ad_study_cell.rb +70 -0
  107. data/lib/facebook_ads/ad_objects/ad_study_objective.rb +73 -0
  108. data/lib/facebook_ads/ad_objects/ad_study_objective_id.rb +38 -0
  109. data/lib/facebook_ads/ad_objects/ad_study_objective_offsite_datasets.rb +37 -0
  110. data/lib/facebook_ads/ad_objects/ad_video.rb +467 -0
  111. data/lib/facebook_ads/ad_objects/adgroup_activity.rb +128 -0
  112. data/lib/facebook_ads/ad_objects/adgroup_issues_info.rb +41 -0
  113. data/lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb +71 -0
  114. data/lib/facebook_ads/ad_objects/adgroup_review_feedback.rb +38 -0
  115. data/lib/facebook_ads/ad_objects/adoptable_pet.rb +85 -0
  116. data/lib/facebook_ads/ad_objects/ads_action_stats.rb +67 -0
  117. data/lib/facebook_ads/ad_objects/ads_image_crops.rb +43 -0
  118. data/lib/facebook_ads/ad_objects/ads_insights.rb +268 -0
  119. data/lib/facebook_ads/ad_objects/ads_optimal_delivery_growth_opportunity.rb +39 -0
  120. data/lib/facebook_ads/ad_objects/ads_pixel.rb +154 -0
  121. data/lib/facebook_ads/ad_objects/ads_pixel_stats.rb +40 -0
  122. data/lib/facebook_ads/ad_objects/ads_pixel_stats_result.rb +58 -0
  123. data/lib/facebook_ads/ad_objects/age_range.rb +38 -0
  124. data/lib/facebook_ads/ad_objects/agency_client_declaration.rb +48 -0
  125. data/lib/facebook_ads/ad_objects/album.rb +155 -0
  126. data/lib/facebook_ads/ad_objects/android_app_link.rb +40 -0
  127. data/lib/facebook_ads/ad_objects/app_request.rb +42 -0
  128. data/lib/facebook_ads/ad_objects/app_request_former_recipient.rb +37 -0
  129. data/lib/facebook_ads/ad_objects/application.rb +617 -0
  130. data/lib/facebook_ads/ad_objects/ar_effects_batch_status.rb +39 -0
  131. data/lib/facebook_ads/ad_objects/assigned_user.rb +39 -0
  132. data/lib/facebook_ads/ad_objects/async_request.rb +52 -0
  133. data/lib/facebook_ads/ad_objects/async_session.rb +49 -0
  134. data/lib/facebook_ads/ad_objects/attribution_spec.rb +38 -0
  135. data/lib/facebook_ads/ad_objects/audience_permission_for_actions.rb +41 -0
  136. data/lib/facebook_ads/ad_objects/audio_copyright.rb +47 -0
  137. data/lib/facebook_ads/ad_objects/automotive_model.rb +110 -0
  138. data/lib/facebook_ads/ad_objects/brand_safety_block_list_usage.rb +41 -0
  139. data/lib/facebook_ads/ad_objects/broad_targeting_categories.rb +47 -0
  140. data/lib/facebook_ads/ad_objects/business.rb +667 -0
  141. data/lib/facebook_ads/ad_objects/business_ad_account_request.rb +37 -0
  142. data/lib/facebook_ads/ad_objects/business_application_request.rb +37 -0
  143. data/lib/facebook_ads/ad_objects/business_asset_group.rb +181 -0
  144. data/lib/facebook_ads/ad_objects/business_asset_sharing_agreement.rb +47 -0
  145. data/lib/facebook_ads/ad_objects/business_image.rb +44 -0
  146. data/lib/facebook_ads/ad_objects/business_managed_partner_eligibility.rb +39 -0
  147. data/lib/facebook_ads/ad_objects/business_owned_object_on_behalf_of_request.rb +47 -0
  148. data/lib/facebook_ads/ad_objects/business_page_request.rb +37 -0
  149. data/lib/facebook_ads/ad_objects/business_role_request.rb +64 -0
  150. data/lib/facebook_ads/ad_objects/business_user.rb +81 -0
  151. data/lib/facebook_ads/ad_objects/campaign.rb +548 -0
  152. data/lib/facebook_ads/ad_objects/campaign_group_brand_configuration.rb +39 -0
  153. data/lib/facebook_ads/ad_objects/campaign_group_collaborative_ads_partner_info.rb +36 -0
  154. data/lib/facebook_ads/ad_objects/canvas.rb +65 -0
  155. data/lib/facebook_ads/ad_objects/canvas_ad_settings.rb +43 -0
  156. data/lib/facebook_ads/ad_objects/canvas_body_element.rb +37 -0
  157. data/lib/facebook_ads/ad_objects/canvas_collection_thumbnail.rb +39 -0
  158. data/lib/facebook_ads/ad_objects/canvas_template.rb +48 -0
  159. data/lib/facebook_ads/ad_objects/catalog_based_targeting.rb +37 -0
  160. data/lib/facebook_ads/ad_objects/catalog_item_app_links.rb +44 -0
  161. data/lib/facebook_ads/ad_objects/catalog_item_appeal_status.rb +40 -0
  162. data/lib/facebook_ads/ad_objects/catalog_item_channels_to_integrity_status.rb +38 -0
  163. data/lib/facebook_ads/ad_objects/catalog_sub_vertical_list.rb +90 -0
  164. data/lib/facebook_ads/ad_objects/chat_plugin.rb +48 -0
  165. data/lib/facebook_ads/ad_objects/check_batch_request_status.rb +43 -0
  166. data/lib/facebook_ads/ad_objects/child_event.rb +39 -0
  167. data/lib/facebook_ads/ad_objects/cloud_game.rb +43 -0
  168. data/lib/facebook_ads/ad_objects/collaborative_ads_partner_info_list_item.rb +36 -0
  169. data/lib/facebook_ads/ad_objects/collaborative_ads_share_settings.rb +39 -0
  170. data/lib/facebook_ads/ad_objects/comment.rb +128 -0
  171. data/lib/facebook_ads/ad_objects/commerce_merchant_settings.rb +142 -0
  172. data/lib/facebook_ads/ad_objects/commerce_merchant_settings_setup_status.rb +42 -0
  173. data/lib/facebook_ads/ad_objects/commerce_order.rb +162 -0
  174. data/lib/facebook_ads/ad_objects/commerce_order_transaction_detail.rb +52 -0
  175. data/lib/facebook_ads/ad_objects/commerce_payout.rb +41 -0
  176. data/lib/facebook_ads/ad_objects/commerce_settings.rb +38 -0
  177. data/lib/facebook_ads/ad_objects/connections_targeting.rb +37 -0
  178. data/lib/facebook_ads/ad_objects/content_delivery_report.rb +92 -0
  179. data/lib/facebook_ads/ad_objects/contextual_bundling_spec.rb +37 -0
  180. data/lib/facebook_ads/ad_objects/conversion_action_query.rb +62 -0
  181. data/lib/facebook_ads/ad_objects/copyright_audio_asset.rb +38 -0
  182. data/lib/facebook_ads/ad_objects/copyright_reference_container.rb +47 -0
  183. data/lib/facebook_ads/ad_objects/cover_photo.rb +40 -0
  184. data/lib/facebook_ads/ad_objects/cpas_advertiser_partnership_recommendation.rb +43 -0
  185. data/lib/facebook_ads/ad_objects/cpas_business_setup_config.rb +43 -0
  186. data/lib/facebook_ads/ad_objects/cpas_collaboration_request.rb +50 -0
  187. data/lib/facebook_ads/ad_objects/cpas_merchant_config.rb +41 -0
  188. data/lib/facebook_ads/ad_objects/creative_history.rb +38 -0
  189. data/lib/facebook_ads/ad_objects/credit_partition_action_options.rb +39 -0
  190. data/lib/facebook_ads/ad_objects/currency.rb +40 -0
  191. data/lib/facebook_ads/ad_objects/currency_amount.rb +40 -0
  192. data/lib/facebook_ads/ad_objects/custom_audience.rb +199 -0
  193. data/lib/facebook_ads/ad_objects/custom_audience_ad_account.rb +36 -0
  194. data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb +108 -0
  195. data/lib/facebook_ads/ad_objects/custom_audience_session.rb +44 -0
  196. data/lib/facebook_ads/ad_objects/custom_audience_sharing_status.rb +38 -0
  197. data/lib/facebook_ads/ad_objects/custom_audience_status.rb +38 -0
  198. data/lib/facebook_ads/ad_objects/custom_audiences_tos.rb +38 -0
  199. data/lib/facebook_ads/ad_objects/custom_audienceshared_account_info.rb +41 -0
  200. data/lib/facebook_ads/ad_objects/custom_conversion.rb +85 -0
  201. data/lib/facebook_ads/ad_objects/custom_conversion_stats_result.rb +50 -0
  202. data/lib/facebook_ads/ad_objects/custom_user_settings.rb +38 -0
  203. data/lib/facebook_ads/ad_objects/da_check.rb +49 -0
  204. data/lib/facebook_ads/ad_objects/day_part.rb +40 -0
  205. data/lib/facebook_ads/ad_objects/delivery_check.rb +40 -0
  206. data/lib/facebook_ads/ad_objects/delivery_check_extra_info.rb +39 -0
  207. data/lib/facebook_ads/ad_objects/delivery_window.rb +287 -0
  208. data/lib/facebook_ads/ad_objects/destination.rb +71 -0
  209. data/lib/facebook_ads/ad_objects/destination_catalog_settings.rb +36 -0
  210. data/lib/facebook_ads/ad_objects/dynamic_content_set.rb +37 -0
  211. data/lib/facebook_ads/ad_objects/dynamic_post_child_attachment.rb +42 -0
  212. data/lib/facebook_ads/ad_objects/dynamic_price_config_by_date.rb +38 -0
  213. data/lib/facebook_ads/ad_objects/engagement.rb +43 -0
  214. data/lib/facebook_ads/ad_objects/entity_at_text_range.rb +49 -0
  215. data/lib/facebook_ads/ad_objects/event.rb +187 -0
  216. data/lib/facebook_ads/ad_objects/event_source_group.rb +44 -0
  217. data/lib/facebook_ads/ad_objects/experience.rb +40 -0
  218. data/lib/facebook_ads/ad_objects/extended_credit.rb +78 -0
  219. data/lib/facebook_ads/ad_objects/extended_credit_allocation_config.rb +60 -0
  220. data/lib/facebook_ads/ad_objects/extended_credit_invoice_group.rb +48 -0
  221. data/lib/facebook_ads/ad_objects/external_event_source.rb +38 -0
  222. data/lib/facebook_ads/ad_objects/fame_export_config.rb +40 -0
  223. data/lib/facebook_ads/ad_objects/flexible_targeting.rb +64 -0
  224. data/lib/facebook_ads/ad_objects/flight.rb +72 -0
  225. data/lib/facebook_ads/ad_objects/funding_source_details.rb +39 -0
  226. data/lib/facebook_ads/ad_objects/funding_source_details_coupon.rb +40 -0
  227. data/lib/facebook_ads/ad_objects/fundraiser_person_to_charity.rb +74 -0
  228. data/lib/facebook_ads/ad_objects/group.rb +572 -0
  229. data/lib/facebook_ads/ad_objects/helpers/custom_audience_helpers.rb +170 -0
  230. data/lib/facebook_ads/ad_objects/home_listing.rb +95 -0
  231. data/lib/facebook_ads/ad_objects/hotel.rb +80 -0
  232. data/lib/facebook_ads/ad_objects/hotel_room.rb +48 -0
  233. data/lib/facebook_ads/ad_objects/id_name.rb +37 -0
  234. data/lib/facebook_ads/ad_objects/ig_comment.rb +49 -0
  235. data/lib/facebook_ads/ad_objects/ig_media.rb +66 -0
  236. data/lib/facebook_ads/ad_objects/ig_user.rb +114 -0
  237. data/lib/facebook_ads/ad_objects/image_copyright.rb +302 -0
  238. data/lib/facebook_ads/ad_objects/insights_result.rb +73 -0
  239. data/lib/facebook_ads/ad_objects/instagram_insights_result.rb +70 -0
  240. data/lib/facebook_ads/ad_objects/instagram_insights_value.rb +38 -0
  241. data/lib/facebook_ads/ad_objects/instagram_user.rb +58 -0
  242. data/lib/facebook_ads/ad_objects/instant_article.rb +52 -0
  243. data/lib/facebook_ads/ad_objects/instant_article_insights_query_result.rb +60 -0
  244. data/lib/facebook_ads/ad_objects/instant_articles_stats.rb +41 -0
  245. data/lib/facebook_ads/ad_objects/ios_app_link.rb +39 -0
  246. data/lib/facebook_ads/ad_objects/jobs_job.rb +72 -0
  247. data/lib/facebook_ads/ad_objects/key_value.rb +38 -0
  248. data/lib/facebook_ads/ad_objects/lead.rb +50 -0
  249. data/lib/facebook_ads/ad_objects/lead_gen_appointment_booking_info.rb +39 -0
  250. data/lib/facebook_ads/ad_objects/lead_gen_conditional_questions_group_choices.rb +39 -0
  251. data/lib/facebook_ads/ad_objects/lead_gen_conditional_questions_group_questions.rb +39 -0
  252. data/lib/facebook_ads/ad_objects/lead_gen_draft_question.rb +44 -0
  253. data/lib/facebook_ads/ad_objects/lead_gen_post_submission_check_result.rb +39 -0
  254. data/lib/facebook_ads/ad_objects/lead_gen_question.rb +44 -0
  255. data/lib/facebook_ads/ad_objects/lead_gen_question_option.rb +38 -0
  256. data/lib/facebook_ads/ad_objects/leadgen_form.rb +108 -0
  257. data/lib/facebook_ads/ad_objects/life_event.rb +46 -0
  258. data/lib/facebook_ads/ad_objects/link.rb +68 -0
  259. data/lib/facebook_ads/ad_objects/live_video.rb +174 -0
  260. data/lib/facebook_ads/ad_objects/live_video_ad_break_config.rb +46 -0
  261. data/lib/facebook_ads/ad_objects/live_video_error.rb +39 -0
  262. data/lib/facebook_ads/ad_objects/live_video_input_stream.rb +42 -0
  263. data/lib/facebook_ads/ad_objects/live_video_recommended_encoder_settings.rb +39 -0
  264. data/lib/facebook_ads/ad_objects/live_video_targeting.rb +40 -0
  265. data/lib/facebook_ads/ad_objects/local_service_business.rb +98 -0
  266. data/lib/facebook_ads/ad_objects/location.rb +49 -0
  267. data/lib/facebook_ads/ad_objects/lookalike_spec.rb +48 -0
  268. data/lib/facebook_ads/ad_objects/mailing_address.rb +42 -0
  269. data/lib/facebook_ads/ad_objects/managed_partner_business.rb +43 -0
  270. data/lib/facebook_ads/ad_objects/media_fingerprint.rb +48 -0
  271. data/lib/facebook_ads/ad_objects/messaging_feature_review.rb +38 -0
  272. data/lib/facebook_ads/ad_objects/messaging_feature_status.rb +37 -0
  273. data/lib/facebook_ads/ad_objects/messenger_destination_page_welcome_message.rb +41 -0
  274. data/lib/facebook_ads/ad_objects/messenger_profile.rb +45 -0
  275. data/lib/facebook_ads/ad_objects/minimum_budget.rb +41 -0
  276. data/lib/facebook_ads/ad_objects/music_video_copyright.rb +48 -0
  277. data/lib/facebook_ads/ad_objects/native_offer.rb +122 -0
  278. data/lib/facebook_ads/ad_objects/native_offer_discount.rb +42 -0
  279. data/lib/facebook_ads/ad_objects/native_offer_view.rb +53 -0
  280. data/lib/facebook_ads/ad_objects/null_node.rb +36 -0
  281. data/lib/facebook_ads/ad_objects/offline_conversion_data_set.rb +143 -0
  282. data/lib/facebook_ads/ad_objects/offline_conversion_data_set_permissions.rb +40 -0
  283. data/lib/facebook_ads/ad_objects/offline_conversion_data_set_upload.rb +71 -0
  284. data/lib/facebook_ads/ad_objects/offline_conversion_data_set_usage.rb +37 -0
  285. data/lib/facebook_ads/ad_objects/offsite_pixel.rb +40 -0
  286. data/lib/facebook_ads/ad_objects/omega_customer_trx.rb +64 -0
  287. data/lib/facebook_ads/ad_objects/open_graph_context.rb +35 -0
  288. data/lib/facebook_ads/ad_objects/outcome_prediction_point.rb +40 -0
  289. data/lib/facebook_ads/ad_objects/page.rb +1523 -0
  290. data/lib/facebook_ads/ad_objects/page_admin_note.rb +39 -0
  291. data/lib/facebook_ads/ad_objects/page_call_to_action.rb +134 -0
  292. data/lib/facebook_ads/ad_objects/page_category.rb +39 -0
  293. data/lib/facebook_ads/ad_objects/page_change_proposal.rb +41 -0
  294. data/lib/facebook_ads/ad_objects/page_commerce_eligibility.rb +38 -0
  295. data/lib/facebook_ads/ad_objects/page_parking.rb +39 -0
  296. data/lib/facebook_ads/ad_objects/page_payment_options.rb +41 -0
  297. data/lib/facebook_ads/ad_objects/page_post.rb +182 -0
  298. data/lib/facebook_ads/ad_objects/page_restaurant_services.rb +46 -0
  299. data/lib/facebook_ads/ad_objects/page_restaurant_specialties.rb +41 -0
  300. data/lib/facebook_ads/ad_objects/page_saved_filter.rb +41 -0
  301. data/lib/facebook_ads/ad_objects/page_settings.rb +38 -0
  302. data/lib/facebook_ads/ad_objects/page_start_info.rb +38 -0
  303. data/lib/facebook_ads/ad_objects/page_thread_owner.rb +37 -0
  304. data/lib/facebook_ads/ad_objects/page_upcoming_change.rb +39 -0
  305. data/lib/facebook_ads/ad_objects/page_user_message_thread_label.rb +44 -0
  306. data/lib/facebook_ads/ad_objects/partner_study.rb +52 -0
  307. data/lib/facebook_ads/ad_objects/payment_engine_payment.rb +74 -0
  308. data/lib/facebook_ads/ad_objects/payment_pricepoints.rb +37 -0
  309. data/lib/facebook_ads/ad_objects/payment_subscription.rb +58 -0
  310. data/lib/facebook_ads/ad_objects/permission.rb +44 -0
  311. data/lib/facebook_ads/ad_objects/persona.rb +36 -0
  312. data/lib/facebook_ads/ad_objects/photo.rb +133 -0
  313. data/lib/facebook_ads/ad_objects/place.rb +38 -0
  314. data/lib/facebook_ads/ad_objects/place_topic.rb +42 -0
  315. data/lib/facebook_ads/ad_objects/platform_image_source.rb +39 -0
  316. data/lib/facebook_ads/ad_objects/playable_content.rb +42 -0
  317. data/lib/facebook_ads/ad_objects/post.rb +229 -0
  318. data/lib/facebook_ads/ad_objects/privacy.rb +42 -0
  319. data/lib/facebook_ads/ad_objects/private_lift_study_instance.rb +48 -0
  320. data/lib/facebook_ads/ad_objects/product_catalog.rb +553 -0
  321. data/lib/facebook_ads/ad_objects/product_catalog_category.rb +50 -0
  322. data/lib/facebook_ads/ad_objects/product_catalog_diagnostic_group.rb +90 -0
  323. data/lib/facebook_ads/ad_objects/product_catalog_hotel_rooms_batch.rb +40 -0
  324. data/lib/facebook_ads/ad_objects/product_catalog_image_settings.rb +38 -0
  325. data/lib/facebook_ads/ad_objects/product_catalog_image_settings_operation.rb +37 -0
  326. data/lib/facebook_ads/ad_objects/product_catalog_pricing_variables_batch.rb +40 -0
  327. data/lib/facebook_ads/ad_objects/product_catalog_product_sets_batch.rb +40 -0
  328. data/lib/facebook_ads/ad_objects/product_event_stat.rb +75 -0
  329. data/lib/facebook_ads/ad_objects/product_feed.rb +232 -0
  330. data/lib/facebook_ads/ad_objects/product_feed_missing_feed_item_replacement.rb +40 -0
  331. data/lib/facebook_ads/ad_objects/product_feed_rule.rb +36 -0
  332. data/lib/facebook_ads/ad_objects/product_feed_rule_suggestion.rb +39 -0
  333. data/lib/facebook_ads/ad_objects/product_feed_schedule.rb +61 -0
  334. data/lib/facebook_ads/ad_objects/product_feed_upload.rb +63 -0
  335. data/lib/facebook_ads/ad_objects/product_feed_upload_error.rb +60 -0
  336. data/lib/facebook_ads/ad_objects/product_feed_upload_error_report.rb +38 -0
  337. data/lib/facebook_ads/ad_objects/product_feed_upload_error_sample.rb +37 -0
  338. data/lib/facebook_ads/ad_objects/product_group.rb +110 -0
  339. data/lib/facebook_ads/ad_objects/product_image.rb +36 -0
  340. data/lib/facebook_ads/ad_objects/product_item.rb +673 -0
  341. data/lib/facebook_ads/ad_objects/product_item_ar_data.rb +59 -0
  342. data/lib/facebook_ads/ad_objects/product_item_commerce_insights.rb +39 -0
  343. data/lib/facebook_ads/ad_objects/product_item_importer_address.rb +42 -0
  344. data/lib/facebook_ads/ad_objects/product_set.rb +100 -0
  345. data/lib/facebook_ads/ad_objects/product_set_metadata.rb +40 -0
  346. data/lib/facebook_ads/ad_objects/product_variant.rb +39 -0
  347. data/lib/facebook_ads/ad_objects/profile.rb +78 -0
  348. data/lib/facebook_ads/ad_objects/profile_picture_source.rb +55 -0
  349. data/lib/facebook_ads/ad_objects/publisher_block_list.rb +54 -0
  350. data/lib/facebook_ads/ad_objects/raw_custom_audience.rb +37 -0
  351. data/lib/facebook_ads/ad_objects/reach_frequency_activity.rb +42 -0
  352. data/lib/facebook_ads/ad_objects/reach_frequency_ad_format.rb +38 -0
  353. data/lib/facebook_ads/ad_objects/reach_frequency_curve_lower_confidence_range.rb +42 -0
  354. data/lib/facebook_ads/ad_objects/reach_frequency_curve_upper_confidence_range.rb +42 -0
  355. data/lib/facebook_ads/ad_objects/reach_frequency_day_part.rb +39 -0
  356. data/lib/facebook_ads/ad_objects/reach_frequency_estimates_curve.rb +44 -0
  357. data/lib/facebook_ads/ad_objects/reach_frequency_estimates_placement_breakdown.rb +48 -0
  358. data/lib/facebook_ads/ad_objects/reach_frequency_prediction.rb +165 -0
  359. data/lib/facebook_ads/ad_objects/reach_frequency_spec.rb +44 -0
  360. data/lib/facebook_ads/ad_objects/recommendation.rb +44 -0
  361. data/lib/facebook_ads/ad_objects/rev_share_policy.rb +38 -0
  362. data/lib/facebook_ads/ad_objects/rich_media_element.rb +39 -0
  363. data/lib/facebook_ads/ad_objects/rtb_dynamic_post.rb +58 -0
  364. data/lib/facebook_ads/ad_objects/saved_audience.rb +50 -0
  365. data/lib/facebook_ads/ad_objects/saved_message_response.rb +40 -0
  366. data/lib/facebook_ads/ad_objects/security_settings.rb +36 -0
  367. data/lib/facebook_ads/ad_objects/server_side/action_source.rb +48 -0
  368. data/lib/facebook_ads/ad_objects/server_side/batch_processor.rb +73 -0
  369. data/lib/facebook_ads/ad_objects/server_side/content.rb +209 -0
  370. data/lib/facebook_ads/ad_objects/server_side/custom_data.rb +395 -0
  371. data/lib/facebook_ads/ad_objects/server_side/delivery_category.rb +33 -0
  372. data/lib/facebook_ads/ad_objects/server_side/event.rb +324 -0
  373. data/lib/facebook_ads/ad_objects/server_side/event_request.rb +296 -0
  374. data/lib/facebook_ads/ad_objects/server_side/event_request_async.rb +43 -0
  375. data/lib/facebook_ads/ad_objects/server_side/event_response.rb +106 -0
  376. data/lib/facebook_ads/ad_objects/server_side/http_method.rb +28 -0
  377. data/lib/facebook_ads/ad_objects/server_side/http_service_interface.rb +33 -0
  378. data/lib/facebook_ads/ad_objects/server_side/http_util.rb +31 -0
  379. data/lib/facebook_ads/ad_objects/server_side/user_data.rb +724 -0
  380. data/lib/facebook_ads/ad_objects/server_side/util.rb +323 -0
  381. data/lib/facebook_ads/ad_objects/shop.rb +37 -0
  382. data/lib/facebook_ads/ad_objects/split_test_winner.rb +39 -0
  383. data/lib/facebook_ads/ad_objects/store_catalog_settings.rb +34 -0
  384. data/lib/facebook_ads/ad_objects/system_user.rb +78 -0
  385. data/lib/facebook_ads/ad_objects/tab.rb +45 -0
  386. data/lib/facebook_ads/ad_objects/targeting.rb +135 -0
  387. data/lib/facebook_ads/ad_objects/targeting_dynamic_rule.rb +44 -0
  388. data/lib/facebook_ads/ad_objects/targeting_geo_location.rb +56 -0
  389. data/lib/facebook_ads/ad_objects/targeting_geo_location_city.rb +43 -0
  390. data/lib/facebook_ads/ad_objects/targeting_geo_location_custom_location.rb +50 -0
  391. data/lib/facebook_ads/ad_objects/targeting_geo_location_electoral_district.rb +40 -0
  392. data/lib/facebook_ads/ad_objects/targeting_geo_location_geo_entities.rb +41 -0
  393. data/lib/facebook_ads/ad_objects/targeting_geo_location_location_cluster.rb +37 -0
  394. data/lib/facebook_ads/ad_objects/targeting_geo_location_location_expansion.rb +37 -0
  395. data/lib/facebook_ads/ad_objects/targeting_geo_location_market.rb +40 -0
  396. data/lib/facebook_ads/ad_objects/targeting_geo_location_place.rb +45 -0
  397. data/lib/facebook_ads/ad_objects/targeting_geo_location_political_district.rb +40 -0
  398. data/lib/facebook_ads/ad_objects/targeting_geo_location_region.rb +39 -0
  399. data/lib/facebook_ads/ad_objects/targeting_geo_location_zip.rb +41 -0
  400. data/lib/facebook_ads/ad_objects/targeting_product_audience_spec.rb +39 -0
  401. data/lib/facebook_ads/ad_objects/targeting_product_audience_sub_spec.rb +38 -0
  402. data/lib/facebook_ads/ad_objects/targeting_prospecting_audience.rb +37 -0
  403. data/lib/facebook_ads/ad_objects/targeting_relaxation.rb +37 -0
  404. data/lib/facebook_ads/ad_objects/targeting_sentence_line.rb +38 -0
  405. data/lib/facebook_ads/ad_objects/text_with_entities.rb +37 -0
  406. data/lib/facebook_ads/ad_objects/third_party_measurement_report_dataset.rb +38 -0
  407. data/lib/facebook_ads/ad_objects/tracking_and_conversion_with_defaults.rb +40 -0
  408. data/lib/facebook_ads/ad_objects/unified_thread.rb +60 -0
  409. data/lib/facebook_ads/ad_objects/url.rb +45 -0
  410. data/lib/facebook_ads/ad_objects/user.rb +671 -0
  411. data/lib/facebook_ads/ad_objects/user_cover_photo.rb +39 -0
  412. data/lib/facebook_ads/ad_objects/user_device.rb +38 -0
  413. data/lib/facebook_ads/ad_objects/user_id_for_app.rb +37 -0
  414. data/lib/facebook_ads/ad_objects/user_id_for_page.rb +37 -0
  415. data/lib/facebook_ads/ad_objects/user_lead_gen_disclaimer_response.rb +38 -0
  416. data/lib/facebook_ads/ad_objects/user_lead_gen_field_data.rb +38 -0
  417. data/lib/facebook_ads/ad_objects/user_payment_mobile_pricepoints.rb +40 -0
  418. data/lib/facebook_ads/ad_objects/value_based_eligible_source.rb +38 -0
  419. data/lib/facebook_ads/ad_objects/vehicle.rb +189 -0
  420. data/lib/facebook_ads/ad_objects/vehicle_offer.rb +91 -0
  421. data/lib/facebook_ads/ad_objects/video_copyright.rb +61 -0
  422. data/lib/facebook_ads/ad_objects/video_copyright_condition_group.rb +39 -0
  423. data/lib/facebook_ads/ad_objects/video_copyright_geo_gate.rb +38 -0
  424. data/lib/facebook_ads/ad_objects/video_copyright_rule.rb +47 -0
  425. data/lib/facebook_ads/ad_objects/video_copyright_segment.rb +39 -0
  426. data/lib/facebook_ads/ad_objects/video_list.rb +47 -0
  427. data/lib/facebook_ads/ad_objects/video_poll.rb +58 -0
  428. data/lib/facebook_ads/ad_objects/video_thumbnail.rb +42 -0
  429. data/lib/facebook_ads/ad_objects/video_upload_limits.rb +38 -0
  430. data/lib/facebook_ads/ad_objects/voip_info.rb +43 -0
  431. data/lib/facebook_ads/ad_objects/web_app_link.rb +38 -0
  432. data/lib/facebook_ads/ad_objects/whats_app_business_account.rb +143 -0
  433. data/lib/facebook_ads/ad_objects/whats_app_business_profile.rb +36 -0
  434. data/lib/facebook_ads/ad_objects/windows_app_link.rb +40 -0
  435. data/lib/facebook_ads/ad_objects/windows_phone_app_link.rb +39 -0
  436. data/lib/facebook_ads/ad_objects/woodhenge_purchased_payg_receipt.rb +38 -0
  437. data/lib/facebook_ads/ad_objects/work_user_frontline.rb +38 -0
  438. data/lib/facebook_ads/api_request.rb +123 -0
  439. data/lib/facebook_ads/api_response.rb +51 -0
  440. data/lib/facebook_ads/batch_api/batch.rb +88 -0
  441. data/lib/facebook_ads/batch_api/batch_proxy.rb +67 -0
  442. data/lib/facebook_ads/config.rb +43 -0
  443. data/lib/facebook_ads/crash_logger.rb +133 -0
  444. data/lib/facebook_ads/edge.rb +185 -0
  445. data/lib/facebook_ads/errors.rb +60 -0
  446. data/lib/facebook_ads/field_types/ad_object.rb +37 -0
  447. data/lib/facebook_ads/field_types/base.rb +33 -0
  448. data/lib/facebook_ads/field_types/boolean.rb +25 -0
  449. data/lib/facebook_ads/field_types/datetime.rb +47 -0
  450. data/lib/facebook_ads/field_types/double.rb +29 -0
  451. data/lib/facebook_ads/field_types/enum.rb +31 -0
  452. data/lib/facebook_ads/field_types/integer.rb +33 -0
  453. data/lib/facebook_ads/field_types/list.rb +57 -0
  454. data/lib/facebook_ads/field_types/object.rb +40 -0
  455. data/lib/facebook_ads/field_types/string_type.rb +39 -0
  456. data/lib/facebook_ads/field_types/upload_file.rb +121 -0
  457. data/lib/facebook_ads/field_types.rb +65 -0
  458. data/lib/facebook_ads/fields.rb +66 -0
  459. data/lib/facebook_ads/helpers/edge_helpers.rb +57 -0
  460. data/lib/facebook_ads/helpers/node_helpers.rb +80 -0
  461. data/lib/facebook_ads/helpers/shortcuts.rb +34 -0
  462. data/lib/facebook_ads/param_set.rb +74 -0
  463. data/lib/facebook_ads/ruby2patch.rb +27 -0
  464. data/lib/facebook_ads/session.rb +102 -0
  465. data/lib/facebook_ads/test/base.rb +98 -0
  466. data/lib/facebook_ads/test/config.rb +55 -0
  467. data/lib/facebook_ads/test/errors.rb +23 -0
  468. data/lib/facebook_ads/test/exit_codes.rb +29 -0
  469. data/lib/facebook_ads/test/exit_hook.rb +35 -0
  470. data/lib/facebook_ads/test/fixtures.rb +107 -0
  471. data/lib/facebook_ads/test.rb +23 -0
  472. data/lib/facebook_ads/utils/utils.rb +29 -0
  473. data/lib/facebook_ads/version.rb +24 -0
  474. data/lib/facebook_ads/videos/video_io.rb +25 -0
  475. data/lib/facebook_ads/videos/video_request.rb +42 -0
  476. data/lib/facebook_ads.rb +82 -0
  477. metadata +743 -0
@@ -0,0 +1,98 @@
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
+ require_relative 'config'
20
+ require_relative 'fixtures'
21
+
22
+ module FacebookAds
23
+ module Test
24
+ module FailuresStore
25
+ def failures
26
+ @failures ||= []
27
+ end
28
+ end
29
+ extend FailuresStore
30
+
31
+ class Base < Minitest::Test
32
+ attr_accessor :cleanup_queue, :config
33
+
34
+ include Fixtures
35
+
36
+ def before_setup
37
+ load_config!
38
+ end
39
+
40
+ def generate(type, *args)
41
+ method = "create_#{type}".to_sym
42
+ if respond_to?(method)
43
+ send(method, *args) do |generated_obj|
44
+ cleanup_later(generated_obj)
45
+ end.tap do |obj|
46
+ cleanup_later(obj)
47
+ end
48
+ else
49
+ raise TestRuntimeError, "#{type} is not a supported generator"
50
+ end
51
+ end
52
+
53
+ def teardown
54
+ return unless cleanup_queue
55
+
56
+ cleanup_queue.reverse.each do |obj_or_id|
57
+ if obj_or_id.is_a?(FacebookAds::AdObject)
58
+ obj_or_id.destroy
59
+ elsif obj_or_id.is_a?(String) || obj_or_id.is_a?(Numeric)
60
+ FacebookAds::AdObject.get(obj_or_id).destroy
61
+ end
62
+ end
63
+ end
64
+
65
+ def after_teardown
66
+ # Collect failures for custom exit code
67
+ FacebookAds::Test.failures.concat(self.failures)
68
+ end
69
+
70
+ private
71
+ def cleanup_later(obj)
72
+ @cleanup_queue ||= []
73
+ @cleanup_queue << obj
74
+ end
75
+
76
+ def load_config!
77
+ @config = FacebookAds::Test::Config.new.override_from! # load overrides from test_config.json
78
+
79
+ FacebookAds.configure do |cf|
80
+ log_level = case ENV['LOG_LEVEL']
81
+ when 'debug'
82
+ ::Logger::DEBUG
83
+ when 'info'
84
+ ::Logger::INFO
85
+ when 'fatal'
86
+ ::Logger::FATAL
87
+ when 'error'
88
+ ::Logger::ERROR
89
+ else # default to warn
90
+ ::Logger::WARN
91
+ end
92
+ cf.logger = ::Logger.new(STDOUT).tap { |d| d.level = log_level }
93
+ cf.access_token = config.access_token
94
+ end
95
+ end
96
+ end
97
+ end
98
+ end
@@ -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
+ module FacebookAds
20
+ module Test
21
+ class Config < FacebookAds::Config
22
+ setting :app_id
23
+ setting :app_secret
24
+ setting :access_token
25
+ setting :business_id
26
+ setting :act_id
27
+ setting :account_id
28
+ setting :act_timezone
29
+ setting :page_id
30
+ setting :app_url
31
+ setting :instagram_actor_id
32
+ setting :graph_base_domain
33
+ setting :secondary_business_id
34
+ setting :secondary_account_id
35
+ setting :secondary_page_id
36
+ setting :secondary_app_id
37
+
38
+ setting :image_path, File.expand_path("../../../../tests/image.png", __FILE__)
39
+ setting :images_zip_path, File.expand_path("../../../../tests/imagez.zip", __FILE__)
40
+ setting :video_path, File.expand_path("../../../../tests/video.mp4", __FILE__)
41
+
42
+ def override_from!(filename = nil)
43
+ filename ||= File.expand_path("../../../../tests/test_config.json", __FILE__)
44
+ if File.exists?(filename)
45
+ settings = JSON.parse(File.read(filename))
46
+
47
+ settings.each do |k,v|
48
+ instance_variable_set("@#{k}", v)
49
+ end
50
+ end
51
+ self
52
+ end
53
+ end
54
+ end
55
+ end
@@ -0,0 +1,23 @@
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
+ module FacebookAds
20
+ module Test
21
+ class TestRuntimeError < Exception; end
22
+ end
23
+ end
@@ -0,0 +1,29 @@
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
+ module FacebookAds
20
+ module Test
21
+ module ExitCodes
22
+ EXTERNAL_ERROR = 41
23
+ FAILURE = 1
24
+ SUCCESS = 0
25
+ USER_ERROR = 40
26
+ USER_SKIP = 42
27
+ end
28
+ end
29
+ 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
+ # Intercept Minitest exit routine and return our own custom exit code
20
+ Minitest.after_run {
21
+ FacebookAds::Test.failures.each do |failure|
22
+ case failure
23
+ when Minitest::Skip
24
+ exit FacebookAds::Test::ExitCodes::USER_SKIP
25
+ when Minitest::UnexpectedError
26
+ e = failure.exception
27
+ if e.is_a?(FacebookAds::ServerError) ||
28
+ e.is_a?(FacebookAds::ClientError)
29
+ exit FacebookAds::Test::ExitCodes::EXTERNAL_ERROR
30
+ else
31
+ exit FacebookAds::Test::ExitCodes::USER_ERROR
32
+ end
33
+ end
34
+ end
35
+ }
@@ -0,0 +1,107 @@
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
+ require 'securerandom'
20
+
21
+ module FacebookAds
22
+ module Test
23
+ module Fixtures
24
+ def ad_account
25
+ FacebookAds::AdAccount.get(config.account_id)
26
+ end
27
+
28
+ def create_adlabel
29
+ ad_account.adlabels.create({
30
+ name: randomize('My ad label')
31
+ })
32
+ end
33
+
34
+ def create_ad(params = {})
35
+ ad_set ||= create_ad_set.tap { |c| yield c if block_given? }
36
+ creative ||= create_creative.tap { |c| yield c if block_given? }
37
+
38
+ params = {
39
+ name: 'My Ad',
40
+ adset_id: ad_set.id,
41
+ creative: {
42
+ creative_id: creative.id,
43
+ },
44
+ status: 'PAUSED',
45
+ }
46
+
47
+ ad = ad_account.ads.create(params)
48
+ end
49
+
50
+ def create_image
51
+ images = ad_account.adimages.create({
52
+ filename: config.image_path
53
+ })
54
+ images[0]
55
+ end
56
+
57
+ def create_campaign(params = {})
58
+ params = {
59
+ name: randomize('Testing Campaign'),
60
+ buying_type: 'AUCTION',
61
+ objective: 'LINK_CLICKS',
62
+ status: 'PAUSED',
63
+ }.merge(params)
64
+
65
+ ad_account.campaigns.create(params)
66
+ end
67
+
68
+ def create_ad_set(campaign = nil, params = {})
69
+ # yield generated object to add them to cleanup queue
70
+ campaign ||= create_campaign.tap { |c| yield c if block_given? }
71
+
72
+ ad_account.adsets.create({
73
+ campaign_id: campaign.id,
74
+ name: randomize('Test AdSet'),
75
+ targeting: {
76
+ geo_locations: { countries: ['US'] }
77
+ },
78
+ optimization_goal: 'IMPRESSIONS',
79
+ billing_event: 'IMPRESSIONS',
80
+ bid_amount: 100,
81
+ daily_budget: 1000,
82
+ })
83
+ end
84
+
85
+ def create_creative(image = nil, params = {})
86
+ image ||= create_image
87
+
88
+ ad_account.adcreatives.create({
89
+ name: randomize('Test Creative'),
90
+ object_story_spec: {
91
+ page_id: config.page_id,
92
+ link_data: {
93
+ message: 'try it out',
94
+ link: config.app_url,
95
+ caption: 'www.example.com',
96
+ image_hash: image.hash,
97
+ }
98
+ }
99
+ })
100
+ end
101
+
102
+ def randomize(string)
103
+ "#{string} #{SecureRandom.hex}"
104
+ end
105
+ end
106
+ end
107
+ end
@@ -0,0 +1,23 @@
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
+ require 'facebook_ads/test/config'
20
+ require 'facebook_ads/test/errors'
21
+ require 'facebook_ads/test/base'
22
+ require 'facebook_ads/test/exit_codes'
23
+ require 'facebook_ads/test/exit_hook'
@@ -0,0 +1,29 @@
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
+ require 'logger'
20
+
21
+ module FacebookAds
22
+ module Utils
23
+ extend self
24
+
25
+ attr_accessor :logger
26
+ self.logger = Logger.new(STDERR)
27
+ self.logger.level = Logger::ERROR
28
+ end
29
+ end
@@ -0,0 +1,24 @@
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
+ VERSION = '0.13.0.0'
23
+ API_VERSION = '13.0'
24
+ end
@@ -0,0 +1,25 @@
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
+ module FacebookAds
20
+ class VideoIO < ::UploadIO
21
+ def is_video?
22
+ true
23
+ end
24
+ end
25
+ end
@@ -0,0 +1,42 @@
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
+ require 'faraday'
20
+
21
+ module FacebookAds
22
+ module HTTPService
23
+ class VideoRequest < Faraday::Middleware
24
+ def call(env)
25
+ if env.body && body_has_video?(env.body)
26
+ env.url.host = env.url.host.gsub(/^graph/, 'graph-video')
27
+ end
28
+ @app.call env
29
+ end
30
+
31
+ def body_has_video?(body)
32
+ if body.respond_to?(:each) && !body.is_a?(String)
33
+ (body.respond_to?(:values) ? body.values : body).any? do |val|
34
+ val.is_a?(FacebookAds::VideoIO)
35
+ end
36
+ else
37
+ false
38
+ end
39
+ end
40
+ end
41
+ end
42
+ end
@@ -0,0 +1,82 @@
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
+ require 'facebook_ads/version'
20
+ require 'facebook_ads/helpers/shortcuts'
21
+ require 'facebook_ads/crash_logger'
22
+
23
+ module FacebookAds
24
+ DEFAULT_API_VERSION = 'v' + API_VERSION
25
+ DEFAULT_HOST = 'graph.facebook.com'
26
+
27
+ extend self
28
+ extend Shortcuts
29
+
30
+ def with_session(access_token, secret = nil, api_version = DEFAULT_API_VERSION)
31
+ original_session = Session.current_session
32
+ Session.current_session = Session.new(access_token, secret, api_version)
33
+ yield
34
+ Session.current_session = original_session
35
+ end
36
+
37
+ def configure
38
+ @config ||= Config.new
39
+ yield @config if block_given?
40
+ CrashLogger.enable if @config.crash_logging_enabled
41
+ @config
42
+ end
43
+
44
+ alias_method :config, :configure
45
+
46
+ require 'facebook_ads/ruby2patch'
47
+
48
+ require 'facebook_ads/config'
49
+ require 'facebook_ads/errors'
50
+ require 'facebook_ads/session'
51
+ require 'facebook_ads/fields'
52
+ require 'facebook_ads/edge'
53
+ require 'facebook_ads/param_set'
54
+ require 'facebook_ads/ad_object'
55
+ require 'facebook_ads/field_types'
56
+
57
+ require 'facebook_ads/utils/utils'
58
+ require 'facebook_ads/videos/video_io'
59
+
60
+ require 'facebook_ads/batch_api/batch'
61
+ require 'facebook_ads/batch_api/batch_proxy'
62
+
63
+ # Autoload Ad Objects Helpers
64
+ Dir.glob(File.expand_path(File.join(__FILE__, '..', 'facebook_ads', 'ad_objects', 'helpers', '*.rb'))).each do |file|
65
+ class_name = File.basename(file, '.rb').split('_').map(&:capitalize).join.to_sym
66
+ autoload class_name, file
67
+ end
68
+
69
+ # Autoload AdObjects
70
+ Dir.glob(File.expand_path(File.join(__FILE__, '..', 'facebook_ads', 'ad_objects', '*.rb'))).each do |file|
71
+ class_name = File.basename(file, '.rb').split('_').map(&:capitalize).join.to_sym
72
+ autoload class_name, file
73
+ end
74
+
75
+ module ServerSide
76
+ # Autoload Server-Side API
77
+ Dir.glob(File.expand_path(File.join(__FILE__, '..', 'facebook_ads', 'ad_objects', 'server_side', '*.rb'))).each do |file|
78
+ class_name = File.basename(file, '.rb').split('_').map(&:capitalize).join.to_sym
79
+ autoload class_name, file
80
+ end
81
+ end
82
+ end