facebookads 0.2.11.0 → 0.999
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- metadata +13 -370
- data/LICENSE.txt +0 -17
- data/README.md +0 -222
- data/lib/facebook_ads/ad_object.rb +0 -179
- data/lib/facebook_ads/ad_objects/ad.rb +0 -220
- data/lib/facebook_ads/ad_objects/ad_account.rb +0 -672
- data/lib/facebook_ads/ad_objects/ad_account_ad_rules_history.rb +0 -45
- data/lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb +0 -64
- data/lib/facebook_ads/ad_objects/ad_account_roas.rb +0 -97
- data/lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb +0 -146
- data/lib/facebook_ads/ad_objects/ad_account_user.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_activity.rb +0 -124
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb +0 -90
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_asset_label.rb +0 -37
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_body.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_caption.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_description.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_group_rule.rb +0 -43
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_image.rb +0 -41
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_link_url.rb +0 -41
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_target_rule.rb +0 -45
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_title.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_asset_feed_spec_video.rb +0 -41
- data/lib/facebook_ads/ad_objects/ad_async_request.rb +0 -67
- data/lib/facebook_ads/ad_objects/ad_async_request_set.rb +0 -68
- data/lib/facebook_ads/ad_objects/ad_async_request_set_notification_result.rb +0 -38
- data/lib/facebook_ads/ad_objects/ad_campaign_delivery_estimate.rb +0 -64
- data/lib/facebook_ads/ad_objects/ad_creative.rb +0 -172
- data/lib/facebook_ads/ad_objects/ad_creative_collection_thumbnail_info.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_creative_link_data.rb +0 -75
- data/lib/facebook_ads/ad_objects/ad_creative_link_data_app_link_spec.rb +0 -40
- data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb +0 -80
- data/lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action_value.rb +0 -46
- data/lib/facebook_ads/ad_objects/ad_creative_link_data_child_attachment.rb +0 -47
- data/lib/facebook_ads/ad_objects/ad_creative_link_data_image_overlay_spec.rb +0 -94
- data/lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb +0 -43
- data/lib/facebook_ads/ad_objects/ad_creative_offer_data.rb +0 -44
- data/lib/facebook_ads/ad_objects/ad_creative_photo_data.rb +0 -43
- data/lib/facebook_ads/ad_objects/ad_creative_place_data.rb +0 -42
- data/lib/facebook_ads/ad_objects/ad_creative_post_click_configuration.rb +0 -38
- data/lib/facebook_ads/ad_objects/ad_creative_text_data.rb +0 -37
- data/lib/facebook_ads/ad_objects/ad_creative_video_data.rb +0 -53
- data/lib/facebook_ads/ad_objects/ad_image.rb +0 -58
- data/lib/facebook_ads/ad_objects/ad_keyword_stats.rb +0 -55
- data/lib/facebook_ads/ad_objects/ad_label.rb +0 -57
- data/lib/facebook_ads/ad_objects/ad_place_page_set.rb +0 -44
- data/lib/facebook_ads/ad_objects/ad_preview.rb +0 -56
- data/lib/facebook_ads/ad_objects/ad_promoted_object.rb +0 -64
- data/lib/facebook_ads/ad_objects/ad_recommendation.rb +0 -55
- data/lib/facebook_ads/ad_objects/ad_recommendation_data.rb +0 -37
- data/lib/facebook_ads/ad_objects/ad_report_run.rb +0 -71
- data/lib/facebook_ads/ad_objects/ad_rule.rb +0 -56
- data/lib/facebook_ads/ad_objects/ad_rule_evaluation_spec.rb +0 -44
- data/lib/facebook_ads/ad_objects/ad_rule_execution_options.rb +0 -44
- data/lib/facebook_ads/ad_objects/ad_rule_execution_spec.rb +0 -49
- data/lib/facebook_ads/ad_objects/ad_rule_filters.rb +0 -55
- data/lib/facebook_ads/ad_objects/ad_rule_history.rb +0 -58
- data/lib/facebook_ads/ad_objects/ad_rule_history_result.rb +0 -45
- data/lib/facebook_ads/ad_objects/ad_rule_history_result_action.rb +0 -40
- data/lib/facebook_ads/ad_objects/ad_rule_schedule.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_rule_schedule_spec.rb +0 -38
- data/lib/facebook_ads/ad_objects/ad_rule_trigger.rb +0 -63
- data/lib/facebook_ads/ad_objects/ad_set.rb +0 -298
- data/lib/facebook_ads/ad_objects/ad_study.rb +0 -70
- data/lib/facebook_ads/ad_objects/ad_study_cell.rb +0 -39
- data/lib/facebook_ads/ad_objects/ad_study_objective.rb +0 -60
- data/lib/facebook_ads/ad_objects/ad_video.rb +0 -25
- data/lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb +0 -43
- data/lib/facebook_ads/ad_objects/adgroup_relevance_score.rb +0 -40
- data/lib/facebook_ads/ad_objects/adgroup_review_feedback.rb +0 -38
- data/lib/facebook_ads/ad_objects/ads_action_stats.rb +0 -55
- data/lib/facebook_ads/ad_objects/ads_data_partner.rb +0 -37
- data/lib/facebook_ads/ad_objects/ads_image_crops.rb +0 -43
- data/lib/facebook_ads/ad_objects/ads_insights.rb +0 -217
- data/lib/facebook_ads/ad_objects/ads_pixel.rb +0 -67
- data/lib/facebook_ads/ad_objects/ads_pixel_stats.rb +0 -40
- data/lib/facebook_ads/ad_objects/ads_pixel_stats_result.rb +0 -50
- data/lib/facebook_ads/ad_objects/agency_client_declaration.rb +0 -48
- data/lib/facebook_ads/ad_objects/android_app_link.rb +0 -40
- data/lib/facebook_ads/ad_objects/app_links.rb +0 -43
- data/lib/facebook_ads/ad_objects/broad_targeting_categories.rb +0 -46
- data/lib/facebook_ads/ad_objects/business.rb +0 -195
- data/lib/facebook_ads/ad_objects/business_ad_account_request.rb +0 -37
- data/lib/facebook_ads/ad_objects/business_page_request.rb +0 -37
- data/lib/facebook_ads/ad_objects/campaign.rb +0 -227
- data/lib/facebook_ads/ad_objects/check_batch_request_status.rb +0 -40
- data/lib/facebook_ads/ad_objects/conversion_action_query.rb +0 -62
- data/lib/facebook_ads/ad_objects/custom_audience.rb +0 -173
- data/lib/facebook_ads/ad_objects/custom_audience_ad_account.rb +0 -36
- data/lib/facebook_ads/ad_objects/custom_audience_data_source.rb +0 -104
- data/lib/facebook_ads/ad_objects/custom_audience_permission.rb +0 -41
- data/lib/facebook_ads/ad_objects/custom_audience_prefill_state.rb +0 -39
- data/lib/facebook_ads/ad_objects/custom_audience_session.rb +0 -44
- data/lib/facebook_ads/ad_objects/custom_audience_status.rb +0 -38
- data/lib/facebook_ads/ad_objects/custom_audiences_tos.rb +0 -38
- data/lib/facebook_ads/ad_objects/custom_conversion.rb +0 -88
- data/lib/facebook_ads/ad_objects/custom_conversion_stats_result.rb +0 -50
- data/lib/facebook_ads/ad_objects/day_part.rb +0 -40
- data/lib/facebook_ads/ad_objects/delivery_check.rb +0 -40
- data/lib/facebook_ads/ad_objects/delivery_check_extra_info.rb +0 -39
- data/lib/facebook_ads/ad_objects/delivery_estimate.rb +0 -41
- data/lib/facebook_ads/ad_objects/domain.rb +0 -37
- data/lib/facebook_ads/ad_objects/event.rb +0 -80
- data/lib/facebook_ads/ad_objects/event_source_group.rb +0 -43
- data/lib/facebook_ads/ad_objects/external_event_source.rb +0 -38
- data/lib/facebook_ads/ad_objects/flexible_targeting.rb +0 -64
- data/lib/facebook_ads/ad_objects/funding_source_details.rb +0 -39
- data/lib/facebook_ads/ad_objects/funding_source_details_coupon.rb +0 -40
- data/lib/facebook_ads/ad_objects/helpers/custom_audience_helpers.rb +0 -170
- data/lib/facebook_ads/ad_objects/hotel.rb +0 -61
- data/lib/facebook_ads/ad_objects/hotel_room.rb +0 -44
- data/lib/facebook_ads/ad_objects/id_name.rb +0 -37
- data/lib/facebook_ads/ad_objects/ios_app_link.rb +0 -39
- data/lib/facebook_ads/ad_objects/lead.rb +0 -47
- data/lib/facebook_ads/ad_objects/lead_gen_qualifier.rb +0 -40
- data/lib/facebook_ads/ad_objects/lead_gen_question.rb +0 -43
- data/lib/facebook_ads/ad_objects/lead_gen_question_option.rb +0 -38
- data/lib/facebook_ads/ad_objects/leadgen_form.rb +0 -73
- data/lib/facebook_ads/ad_objects/legacy_business_ad_account_request.rb +0 -38
- data/lib/facebook_ads/ad_objects/lookalike_spec.rb +0 -43
- data/lib/facebook_ads/ad_objects/minimum_budget.rb +0 -41
- data/lib/facebook_ads/ad_objects/offline_conversion_data_set.rb +0 -99
- data/lib/facebook_ads/ad_objects/offsite_pixel.rb +0 -57
- data/lib/facebook_ads/ad_objects/outcome_prediction_point.rb +0 -40
- data/lib/facebook_ads/ad_objects/partner_category.rb +0 -51
- data/lib/facebook_ads/ad_objects/product_catalog.rb +0 -287
- data/lib/facebook_ads/ad_objects/product_catalog_hotel_rooms_batch.rb +0 -50
- data/lib/facebook_ads/ad_objects/product_catalog_image_settings.rb +0 -38
- data/lib/facebook_ads/ad_objects/product_catalog_image_settings_operation.rb +0 -37
- data/lib/facebook_ads/ad_objects/product_catalog_pricing_variables_batch.rb +0 -50
- data/lib/facebook_ads/ad_objects/product_feed.rb +0 -91
- data/lib/facebook_ads/ad_objects/product_feed_schedule.rb +0 -62
- data/lib/facebook_ads/ad_objects/product_feed_upload.rb +0 -50
- data/lib/facebook_ads/ad_objects/product_feed_upload_error.rb +0 -49
- data/lib/facebook_ads/ad_objects/product_feed_upload_error_sample.rb +0 -37
- data/lib/facebook_ads/ad_objects/product_group.rb +0 -94
- data/lib/facebook_ads/ad_objects/product_item.rb +0 -148
- data/lib/facebook_ads/ad_objects/product_item_commerce_insights.rb +0 -39
- data/lib/facebook_ads/ad_objects/product_set.rb +0 -45
- data/lib/facebook_ads/ad_objects/product_variant.rb +0 -39
- data/lib/facebook_ads/ad_objects/profile_picture_source.rb +0 -52
- data/lib/facebook_ads/ad_objects/rate_card.rb +0 -39
- data/lib/facebook_ads/ad_objects/reach_estimate.rb +0 -62
- data/lib/facebook_ads/ad_objects/reach_frequency_prediction.rb +0 -89
- data/lib/facebook_ads/ad_objects/reach_frequency_spec.rb +0 -43
- data/lib/facebook_ads/ad_objects/rev_share_policy.rb +0 -38
- data/lib/facebook_ads/ad_objects/roas_cohorts_data.rb +0 -41
- data/lib/facebook_ads/ad_objects/roas_cohorts_per_cohort_interval_unit.rb +0 -38
- data/lib/facebook_ads/ad_objects/targeting.rb +0 -133
- data/lib/facebook_ads/ad_objects/targeting_dynamic_rule.rb +0 -44
- data/lib/facebook_ads/ad_objects/targeting_geo_location.rb +0 -47
- data/lib/facebook_ads/ad_objects/targeting_geo_location_city.rb +0 -43
- data/lib/facebook_ads/ad_objects/targeting_geo_location_custom_location.rb +0 -50
- data/lib/facebook_ads/ad_objects/targeting_geo_location_electoral_district.rb +0 -40
- data/lib/facebook_ads/ad_objects/targeting_geo_location_market.rb +0 -40
- data/lib/facebook_ads/ad_objects/targeting_geo_location_place.rb +0 -45
- data/lib/facebook_ads/ad_objects/targeting_geo_location_political_district.rb +0 -40
- data/lib/facebook_ads/ad_objects/targeting_geo_location_region.rb +0 -39
- data/lib/facebook_ads/ad_objects/targeting_geo_location_zip.rb +0 -41
- data/lib/facebook_ads/ad_objects/targeting_product_audience_spec.rb +0 -39
- data/lib/facebook_ads/ad_objects/targeting_product_audience_sub_spec.rb +0 -38
- data/lib/facebook_ads/ad_objects/targeting_sentence_line.rb +0 -38
- data/lib/facebook_ads/ad_objects/transaction.rb +0 -57
- data/lib/facebook_ads/ad_objects/transaction_currency_amount.rb +0 -39
- data/lib/facebook_ads/ad_objects/user.rb +0 -130
- data/lib/facebook_ads/ad_objects/user_lead_gen_disclaimer_response.rb +0 -38
- data/lib/facebook_ads/ad_objects/user_lead_gen_field_data.rb +0 -38
- data/lib/facebook_ads/ad_objects/video_thumbnail.rb +0 -42
- data/lib/facebook_ads/ad_objects/web_app_link.rb +0 -38
- data/lib/facebook_ads/ad_objects/windows_app_link.rb +0 -40
- data/lib/facebook_ads/ad_objects/windows_phone_app_link.rb +0 -39
- data/lib/facebook_ads/api_request.rb +0 -123
- data/lib/facebook_ads/api_response.rb +0 -47
- data/lib/facebook_ads/batch_api/batch.rb +0 -86
- data/lib/facebook_ads/batch_api/batch_proxy.rb +0 -67
- data/lib/facebook_ads/config.rb +0 -43
- data/lib/facebook_ads/edge.rb +0 -184
- data/lib/facebook_ads/errors.rb +0 -55
- data/lib/facebook_ads/field_types/ad_object.rb +0 -37
- data/lib/facebook_ads/field_types/base.rb +0 -33
- data/lib/facebook_ads/field_types/boolean.rb +0 -25
- data/lib/facebook_ads/field_types/datetime.rb +0 -51
- data/lib/facebook_ads/field_types/double.rb +0 -29
- data/lib/facebook_ads/field_types/enum.rb +0 -31
- data/lib/facebook_ads/field_types/integer.rb +0 -33
- data/lib/facebook_ads/field_types/list.rb +0 -57
- data/lib/facebook_ads/field_types/object.rb +0 -33
- data/lib/facebook_ads/field_types/string_type.rb +0 -34
- data/lib/facebook_ads/field_types/upload_file.rb +0 -121
- data/lib/facebook_ads/field_types.rb +0 -65
- data/lib/facebook_ads/fields.rb +0 -66
- data/lib/facebook_ads/helpers/edge_helpers.rb +0 -57
- data/lib/facebook_ads/helpers/node_helpers.rb +0 -80
- data/lib/facebook_ads/helpers/shortcuts.rb +0 -34
- data/lib/facebook_ads/param_set.rb +0 -74
- data/lib/facebook_ads/ruby2patch.rb +0 -27
- data/lib/facebook_ads/session.rb +0 -98
- data/lib/facebook_ads/utils/utils.rb +0 -29
- data/lib/facebook_ads/version.rb +0 -24
- data/lib/facebook_ads/videos/video_io.rb +0 -25
- data/lib/facebook_ads/videos/video_request.rb +0 -42
- data/lib/facebook_ads.rb +0 -72
- data/lib/facebookads.rb +0 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 3e21d42c25e4c0892720fb7a9aa9c3eac2c8d6c042646696c514dfbc91097b42
|
4
|
+
data.tar.gz: b8d1fa1d55a2a349f7bdfb6aa0f39b17af6d315773210e5b38415caa565e1ace
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9ae3dddbddb0c2af9b0dd8af00bf151481580dc1d8c627fc8b4ed0adbfceb12f600e9ee2501729543ce944a6dab00244788c02839a2037d4aec3daca79d5aa44
|
7
|
+
data.tar.gz: ee92f16e04307a8bd9857bc330cfe0c6f6933c4e83ea469b1f37c49863fbcf3b04d29250163205c15b563513c5f03e75cacb6e31db03d5a514302a47dc67c46e
|
metadata
CHANGED
@@ -1,384 +1,28 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: facebookads
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: '0.999'
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Facebook
|
8
|
-
autorequire:
|
8
|
+
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
12
|
-
dependencies:
|
13
|
-
|
14
|
-
name: faraday
|
15
|
-
requirement: !ruby/object:Gem::Requirement
|
16
|
-
requirements:
|
17
|
-
- - ">="
|
18
|
-
- !ruby/object:Gem::Version
|
19
|
-
version: '0'
|
20
|
-
type: :runtime
|
21
|
-
prerelease: false
|
22
|
-
version_requirements: !ruby/object:Gem::Requirement
|
23
|
-
requirements:
|
24
|
-
- - ">="
|
25
|
-
- !ruby/object:Gem::Version
|
26
|
-
version: '0'
|
27
|
-
- !ruby/object:Gem::Dependency
|
28
|
-
name: json
|
29
|
-
requirement: !ruby/object:Gem::Requirement
|
30
|
-
requirements:
|
31
|
-
- - ">="
|
32
|
-
- !ruby/object:Gem::Version
|
33
|
-
version: '0'
|
34
|
-
type: :runtime
|
35
|
-
prerelease: false
|
36
|
-
version_requirements: !ruby/object:Gem::Requirement
|
37
|
-
requirements:
|
38
|
-
- - ">="
|
39
|
-
- !ruby/object:Gem::Version
|
40
|
-
version: '0'
|
41
|
-
- !ruby/object:Gem::Dependency
|
42
|
-
name: rake
|
43
|
-
requirement: !ruby/object:Gem::Requirement
|
44
|
-
requirements:
|
45
|
-
- - ">="
|
46
|
-
- !ruby/object:Gem::Version
|
47
|
-
version: '0'
|
48
|
-
type: :development
|
49
|
-
prerelease: false
|
50
|
-
version_requirements: !ruby/object:Gem::Requirement
|
51
|
-
requirements:
|
52
|
-
- - ">="
|
53
|
-
- !ruby/object:Gem::Version
|
54
|
-
version: '0'
|
55
|
-
- !ruby/object:Gem::Dependency
|
56
|
-
name: byebug
|
57
|
-
requirement: !ruby/object:Gem::Requirement
|
58
|
-
requirements:
|
59
|
-
- - ">="
|
60
|
-
- !ruby/object:Gem::Version
|
61
|
-
version: '0'
|
62
|
-
type: :development
|
63
|
-
prerelease: false
|
64
|
-
version_requirements: !ruby/object:Gem::Requirement
|
65
|
-
requirements:
|
66
|
-
- - ">="
|
67
|
-
- !ruby/object:Gem::Version
|
68
|
-
version: '0'
|
69
|
-
- !ruby/object:Gem::Dependency
|
70
|
-
name: minitest
|
71
|
-
requirement: !ruby/object:Gem::Requirement
|
72
|
-
requirements:
|
73
|
-
- - ">="
|
74
|
-
- !ruby/object:Gem::Version
|
75
|
-
version: 5.0.0
|
76
|
-
type: :development
|
77
|
-
prerelease: false
|
78
|
-
version_requirements: !ruby/object:Gem::Requirement
|
79
|
-
requirements:
|
80
|
-
- - ">="
|
81
|
-
- !ruby/object:Gem::Version
|
82
|
-
version: 5.0.0
|
83
|
-
- !ruby/object:Gem::Dependency
|
84
|
-
name: pry
|
85
|
-
requirement: !ruby/object:Gem::Requirement
|
86
|
-
requirements:
|
87
|
-
- - ">="
|
88
|
-
- !ruby/object:Gem::Version
|
89
|
-
version: '0'
|
90
|
-
type: :development
|
91
|
-
prerelease: false
|
92
|
-
version_requirements: !ruby/object:Gem::Requirement
|
93
|
-
requirements:
|
94
|
-
- - ">="
|
95
|
-
- !ruby/object:Gem::Version
|
96
|
-
version: '0'
|
97
|
-
- !ruby/object:Gem::Dependency
|
98
|
-
name: pry-coolline
|
99
|
-
requirement: !ruby/object:Gem::Requirement
|
100
|
-
requirements:
|
101
|
-
- - ">="
|
102
|
-
- !ruby/object:Gem::Version
|
103
|
-
version: '0'
|
104
|
-
type: :development
|
105
|
-
prerelease: false
|
106
|
-
version_requirements: !ruby/object:Gem::Requirement
|
107
|
-
requirements:
|
108
|
-
- - ">="
|
109
|
-
- !ruby/object:Gem::Version
|
110
|
-
version: '0'
|
111
|
-
- !ruby/object:Gem::Dependency
|
112
|
-
name: dotenv
|
113
|
-
requirement: !ruby/object:Gem::Requirement
|
114
|
-
requirements:
|
115
|
-
- - ">="
|
116
|
-
- !ruby/object:Gem::Version
|
117
|
-
version: '0'
|
118
|
-
type: :development
|
119
|
-
prerelease: false
|
120
|
-
version_requirements: !ruby/object:Gem::Requirement
|
121
|
-
requirements:
|
122
|
-
- - ">="
|
123
|
-
- !ruby/object:Gem::Version
|
124
|
-
version: '0'
|
125
|
-
- !ruby/object:Gem::Dependency
|
126
|
-
name: awesome_print
|
127
|
-
requirement: !ruby/object:Gem::Requirement
|
128
|
-
requirements:
|
129
|
-
- - ">="
|
130
|
-
- !ruby/object:Gem::Version
|
131
|
-
version: '0'
|
132
|
-
type: :development
|
133
|
-
prerelease: false
|
134
|
-
version_requirements: !ruby/object:Gem::Requirement
|
135
|
-
requirements:
|
136
|
-
- - ">="
|
137
|
-
- !ruby/object:Gem::Version
|
138
|
-
version: '0'
|
139
|
-
- !ruby/object:Gem::Dependency
|
140
|
-
name: rspec
|
141
|
-
requirement: !ruby/object:Gem::Requirement
|
142
|
-
requirements:
|
143
|
-
- - ">="
|
144
|
-
- !ruby/object:Gem::Version
|
145
|
-
version: '0'
|
146
|
-
type: :development
|
147
|
-
prerelease: false
|
148
|
-
version_requirements: !ruby/object:Gem::Requirement
|
149
|
-
requirements:
|
150
|
-
- - ">="
|
151
|
-
- !ruby/object:Gem::Version
|
152
|
-
version: '0'
|
153
|
-
- !ruby/object:Gem::Dependency
|
154
|
-
name: bundler
|
155
|
-
requirement: !ruby/object:Gem::Requirement
|
156
|
-
requirements:
|
157
|
-
- - ">="
|
158
|
-
- !ruby/object:Gem::Version
|
159
|
-
version: '0'
|
160
|
-
type: :development
|
161
|
-
prerelease: false
|
162
|
-
version_requirements: !ruby/object:Gem::Requirement
|
163
|
-
requirements:
|
164
|
-
- - ">="
|
165
|
-
- !ruby/object:Gem::Version
|
166
|
-
version: '0'
|
167
|
-
description: |2
|
168
|
-
The official Facebook Ads API SDK for Ruby.
|
169
|
-
https://developers.facebook.com/docs/marketing-api/sdks'
|
11
|
+
date: 2023-01-18 00:00:00.000000000 Z
|
12
|
+
dependencies: []
|
13
|
+
description: "[Deprecated] Please use facebookbusiness gem instead"
|
170
14
|
email: ''
|
171
15
|
executables: []
|
172
16
|
extensions: []
|
173
17
|
extra_rdoc_files: []
|
174
|
-
files:
|
175
|
-
|
176
|
-
- README.md
|
177
|
-
- lib/facebook_ads.rb
|
178
|
-
- lib/facebook_ads/ad_object.rb
|
179
|
-
- lib/facebook_ads/ad_objects/ad.rb
|
180
|
-
- lib/facebook_ads/ad_objects/ad_account.rb
|
181
|
-
- lib/facebook_ads/ad_objects/ad_account_ad_rules_history.rb
|
182
|
-
- lib/facebook_ads/ad_objects/ad_account_delivery_estimate.rb
|
183
|
-
- lib/facebook_ads/ad_objects/ad_account_roas.rb
|
184
|
-
- lib/facebook_ads/ad_objects/ad_account_targeting_unified.rb
|
185
|
-
- lib/facebook_ads/ad_objects/ad_account_user.rb
|
186
|
-
- lib/facebook_ads/ad_objects/ad_activity.rb
|
187
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec.rb
|
188
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_asset_label.rb
|
189
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_body.rb
|
190
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_caption.rb
|
191
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_description.rb
|
192
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_group_rule.rb
|
193
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_image.rb
|
194
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_link_url.rb
|
195
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_target_rule.rb
|
196
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_title.rb
|
197
|
-
- lib/facebook_ads/ad_objects/ad_asset_feed_spec_video.rb
|
198
|
-
- lib/facebook_ads/ad_objects/ad_async_request.rb
|
199
|
-
- lib/facebook_ads/ad_objects/ad_async_request_set.rb
|
200
|
-
- lib/facebook_ads/ad_objects/ad_async_request_set_notification_result.rb
|
201
|
-
- lib/facebook_ads/ad_objects/ad_campaign_delivery_estimate.rb
|
202
|
-
- lib/facebook_ads/ad_objects/ad_creative.rb
|
203
|
-
- lib/facebook_ads/ad_objects/ad_creative_collection_thumbnail_info.rb
|
204
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data.rb
|
205
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data_app_link_spec.rb
|
206
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action.rb
|
207
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data_call_to_action_value.rb
|
208
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data_child_attachment.rb
|
209
|
-
- lib/facebook_ads/ad_objects/ad_creative_link_data_image_overlay_spec.rb
|
210
|
-
- lib/facebook_ads/ad_objects/ad_creative_object_story_spec.rb
|
211
|
-
- lib/facebook_ads/ad_objects/ad_creative_offer_data.rb
|
212
|
-
- lib/facebook_ads/ad_objects/ad_creative_photo_data.rb
|
213
|
-
- lib/facebook_ads/ad_objects/ad_creative_place_data.rb
|
214
|
-
- lib/facebook_ads/ad_objects/ad_creative_post_click_configuration.rb
|
215
|
-
- lib/facebook_ads/ad_objects/ad_creative_text_data.rb
|
216
|
-
- lib/facebook_ads/ad_objects/ad_creative_video_data.rb
|
217
|
-
- lib/facebook_ads/ad_objects/ad_image.rb
|
218
|
-
- lib/facebook_ads/ad_objects/ad_keyword_stats.rb
|
219
|
-
- lib/facebook_ads/ad_objects/ad_label.rb
|
220
|
-
- lib/facebook_ads/ad_objects/ad_place_page_set.rb
|
221
|
-
- lib/facebook_ads/ad_objects/ad_preview.rb
|
222
|
-
- lib/facebook_ads/ad_objects/ad_promoted_object.rb
|
223
|
-
- lib/facebook_ads/ad_objects/ad_recommendation.rb
|
224
|
-
- lib/facebook_ads/ad_objects/ad_recommendation_data.rb
|
225
|
-
- lib/facebook_ads/ad_objects/ad_report_run.rb
|
226
|
-
- lib/facebook_ads/ad_objects/ad_rule.rb
|
227
|
-
- lib/facebook_ads/ad_objects/ad_rule_evaluation_spec.rb
|
228
|
-
- lib/facebook_ads/ad_objects/ad_rule_execution_options.rb
|
229
|
-
- lib/facebook_ads/ad_objects/ad_rule_execution_spec.rb
|
230
|
-
- lib/facebook_ads/ad_objects/ad_rule_filters.rb
|
231
|
-
- lib/facebook_ads/ad_objects/ad_rule_history.rb
|
232
|
-
- lib/facebook_ads/ad_objects/ad_rule_history_result.rb
|
233
|
-
- lib/facebook_ads/ad_objects/ad_rule_history_result_action.rb
|
234
|
-
- lib/facebook_ads/ad_objects/ad_rule_schedule.rb
|
235
|
-
- lib/facebook_ads/ad_objects/ad_rule_schedule_spec.rb
|
236
|
-
- lib/facebook_ads/ad_objects/ad_rule_trigger.rb
|
237
|
-
- lib/facebook_ads/ad_objects/ad_set.rb
|
238
|
-
- lib/facebook_ads/ad_objects/ad_study.rb
|
239
|
-
- lib/facebook_ads/ad_objects/ad_study_cell.rb
|
240
|
-
- lib/facebook_ads/ad_objects/ad_study_objective.rb
|
241
|
-
- lib/facebook_ads/ad_objects/ad_video.rb
|
242
|
-
- lib/facebook_ads/ad_objects/adgroup_placement_specific_review_feedback.rb
|
243
|
-
- lib/facebook_ads/ad_objects/adgroup_relevance_score.rb
|
244
|
-
- lib/facebook_ads/ad_objects/adgroup_review_feedback.rb
|
245
|
-
- lib/facebook_ads/ad_objects/ads_action_stats.rb
|
246
|
-
- lib/facebook_ads/ad_objects/ads_data_partner.rb
|
247
|
-
- lib/facebook_ads/ad_objects/ads_image_crops.rb
|
248
|
-
- lib/facebook_ads/ad_objects/ads_insights.rb
|
249
|
-
- lib/facebook_ads/ad_objects/ads_pixel.rb
|
250
|
-
- lib/facebook_ads/ad_objects/ads_pixel_stats.rb
|
251
|
-
- lib/facebook_ads/ad_objects/ads_pixel_stats_result.rb
|
252
|
-
- lib/facebook_ads/ad_objects/agency_client_declaration.rb
|
253
|
-
- lib/facebook_ads/ad_objects/android_app_link.rb
|
254
|
-
- lib/facebook_ads/ad_objects/app_links.rb
|
255
|
-
- lib/facebook_ads/ad_objects/broad_targeting_categories.rb
|
256
|
-
- lib/facebook_ads/ad_objects/business.rb
|
257
|
-
- lib/facebook_ads/ad_objects/business_ad_account_request.rb
|
258
|
-
- lib/facebook_ads/ad_objects/business_page_request.rb
|
259
|
-
- lib/facebook_ads/ad_objects/campaign.rb
|
260
|
-
- lib/facebook_ads/ad_objects/check_batch_request_status.rb
|
261
|
-
- lib/facebook_ads/ad_objects/conversion_action_query.rb
|
262
|
-
- lib/facebook_ads/ad_objects/custom_audience.rb
|
263
|
-
- lib/facebook_ads/ad_objects/custom_audience_ad_account.rb
|
264
|
-
- lib/facebook_ads/ad_objects/custom_audience_data_source.rb
|
265
|
-
- lib/facebook_ads/ad_objects/custom_audience_permission.rb
|
266
|
-
- lib/facebook_ads/ad_objects/custom_audience_prefill_state.rb
|
267
|
-
- lib/facebook_ads/ad_objects/custom_audience_session.rb
|
268
|
-
- lib/facebook_ads/ad_objects/custom_audience_status.rb
|
269
|
-
- lib/facebook_ads/ad_objects/custom_audiences_tos.rb
|
270
|
-
- lib/facebook_ads/ad_objects/custom_conversion.rb
|
271
|
-
- lib/facebook_ads/ad_objects/custom_conversion_stats_result.rb
|
272
|
-
- lib/facebook_ads/ad_objects/day_part.rb
|
273
|
-
- lib/facebook_ads/ad_objects/delivery_check.rb
|
274
|
-
- lib/facebook_ads/ad_objects/delivery_check_extra_info.rb
|
275
|
-
- lib/facebook_ads/ad_objects/delivery_estimate.rb
|
276
|
-
- lib/facebook_ads/ad_objects/domain.rb
|
277
|
-
- lib/facebook_ads/ad_objects/event.rb
|
278
|
-
- lib/facebook_ads/ad_objects/event_source_group.rb
|
279
|
-
- lib/facebook_ads/ad_objects/external_event_source.rb
|
280
|
-
- lib/facebook_ads/ad_objects/flexible_targeting.rb
|
281
|
-
- lib/facebook_ads/ad_objects/funding_source_details.rb
|
282
|
-
- lib/facebook_ads/ad_objects/funding_source_details_coupon.rb
|
283
|
-
- lib/facebook_ads/ad_objects/helpers/custom_audience_helpers.rb
|
284
|
-
- lib/facebook_ads/ad_objects/hotel.rb
|
285
|
-
- lib/facebook_ads/ad_objects/hotel_room.rb
|
286
|
-
- lib/facebook_ads/ad_objects/id_name.rb
|
287
|
-
- lib/facebook_ads/ad_objects/ios_app_link.rb
|
288
|
-
- lib/facebook_ads/ad_objects/lead.rb
|
289
|
-
- lib/facebook_ads/ad_objects/lead_gen_qualifier.rb
|
290
|
-
- lib/facebook_ads/ad_objects/lead_gen_question.rb
|
291
|
-
- lib/facebook_ads/ad_objects/lead_gen_question_option.rb
|
292
|
-
- lib/facebook_ads/ad_objects/leadgen_form.rb
|
293
|
-
- lib/facebook_ads/ad_objects/legacy_business_ad_account_request.rb
|
294
|
-
- lib/facebook_ads/ad_objects/lookalike_spec.rb
|
295
|
-
- lib/facebook_ads/ad_objects/minimum_budget.rb
|
296
|
-
- lib/facebook_ads/ad_objects/offline_conversion_data_set.rb
|
297
|
-
- lib/facebook_ads/ad_objects/offsite_pixel.rb
|
298
|
-
- lib/facebook_ads/ad_objects/outcome_prediction_point.rb
|
299
|
-
- lib/facebook_ads/ad_objects/partner_category.rb
|
300
|
-
- lib/facebook_ads/ad_objects/product_catalog.rb
|
301
|
-
- lib/facebook_ads/ad_objects/product_catalog_hotel_rooms_batch.rb
|
302
|
-
- lib/facebook_ads/ad_objects/product_catalog_image_settings.rb
|
303
|
-
- lib/facebook_ads/ad_objects/product_catalog_image_settings_operation.rb
|
304
|
-
- lib/facebook_ads/ad_objects/product_catalog_pricing_variables_batch.rb
|
305
|
-
- lib/facebook_ads/ad_objects/product_feed.rb
|
306
|
-
- lib/facebook_ads/ad_objects/product_feed_schedule.rb
|
307
|
-
- lib/facebook_ads/ad_objects/product_feed_upload.rb
|
308
|
-
- lib/facebook_ads/ad_objects/product_feed_upload_error.rb
|
309
|
-
- lib/facebook_ads/ad_objects/product_feed_upload_error_sample.rb
|
310
|
-
- lib/facebook_ads/ad_objects/product_group.rb
|
311
|
-
- lib/facebook_ads/ad_objects/product_item.rb
|
312
|
-
- lib/facebook_ads/ad_objects/product_item_commerce_insights.rb
|
313
|
-
- lib/facebook_ads/ad_objects/product_set.rb
|
314
|
-
- lib/facebook_ads/ad_objects/product_variant.rb
|
315
|
-
- lib/facebook_ads/ad_objects/profile_picture_source.rb
|
316
|
-
- lib/facebook_ads/ad_objects/rate_card.rb
|
317
|
-
- lib/facebook_ads/ad_objects/reach_estimate.rb
|
318
|
-
- lib/facebook_ads/ad_objects/reach_frequency_prediction.rb
|
319
|
-
- lib/facebook_ads/ad_objects/reach_frequency_spec.rb
|
320
|
-
- lib/facebook_ads/ad_objects/rev_share_policy.rb
|
321
|
-
- lib/facebook_ads/ad_objects/roas_cohorts_data.rb
|
322
|
-
- lib/facebook_ads/ad_objects/roas_cohorts_per_cohort_interval_unit.rb
|
323
|
-
- lib/facebook_ads/ad_objects/targeting.rb
|
324
|
-
- lib/facebook_ads/ad_objects/targeting_dynamic_rule.rb
|
325
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location.rb
|
326
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_city.rb
|
327
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_custom_location.rb
|
328
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_electoral_district.rb
|
329
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_market.rb
|
330
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_place.rb
|
331
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_political_district.rb
|
332
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_region.rb
|
333
|
-
- lib/facebook_ads/ad_objects/targeting_geo_location_zip.rb
|
334
|
-
- lib/facebook_ads/ad_objects/targeting_product_audience_spec.rb
|
335
|
-
- lib/facebook_ads/ad_objects/targeting_product_audience_sub_spec.rb
|
336
|
-
- lib/facebook_ads/ad_objects/targeting_sentence_line.rb
|
337
|
-
- lib/facebook_ads/ad_objects/transaction.rb
|
338
|
-
- lib/facebook_ads/ad_objects/transaction_currency_amount.rb
|
339
|
-
- lib/facebook_ads/ad_objects/user.rb
|
340
|
-
- lib/facebook_ads/ad_objects/user_lead_gen_disclaimer_response.rb
|
341
|
-
- lib/facebook_ads/ad_objects/user_lead_gen_field_data.rb
|
342
|
-
- lib/facebook_ads/ad_objects/video_thumbnail.rb
|
343
|
-
- lib/facebook_ads/ad_objects/web_app_link.rb
|
344
|
-
- lib/facebook_ads/ad_objects/windows_app_link.rb
|
345
|
-
- lib/facebook_ads/ad_objects/windows_phone_app_link.rb
|
346
|
-
- lib/facebook_ads/api_request.rb
|
347
|
-
- lib/facebook_ads/api_response.rb
|
348
|
-
- lib/facebook_ads/batch_api/batch.rb
|
349
|
-
- lib/facebook_ads/batch_api/batch_proxy.rb
|
350
|
-
- lib/facebook_ads/config.rb
|
351
|
-
- lib/facebook_ads/edge.rb
|
352
|
-
- lib/facebook_ads/errors.rb
|
353
|
-
- lib/facebook_ads/field_types.rb
|
354
|
-
- lib/facebook_ads/field_types/ad_object.rb
|
355
|
-
- lib/facebook_ads/field_types/base.rb
|
356
|
-
- lib/facebook_ads/field_types/boolean.rb
|
357
|
-
- lib/facebook_ads/field_types/datetime.rb
|
358
|
-
- lib/facebook_ads/field_types/double.rb
|
359
|
-
- lib/facebook_ads/field_types/enum.rb
|
360
|
-
- lib/facebook_ads/field_types/integer.rb
|
361
|
-
- lib/facebook_ads/field_types/list.rb
|
362
|
-
- lib/facebook_ads/field_types/object.rb
|
363
|
-
- lib/facebook_ads/field_types/string_type.rb
|
364
|
-
- lib/facebook_ads/field_types/upload_file.rb
|
365
|
-
- lib/facebook_ads/fields.rb
|
366
|
-
- lib/facebook_ads/helpers/edge_helpers.rb
|
367
|
-
- lib/facebook_ads/helpers/node_helpers.rb
|
368
|
-
- lib/facebook_ads/helpers/shortcuts.rb
|
369
|
-
- lib/facebook_ads/param_set.rb
|
370
|
-
- lib/facebook_ads/ruby2patch.rb
|
371
|
-
- lib/facebook_ads/session.rb
|
372
|
-
- lib/facebook_ads/utils/utils.rb
|
373
|
-
- lib/facebook_ads/version.rb
|
374
|
-
- lib/facebook_ads/videos/video_io.rb
|
375
|
-
- lib/facebook_ads/videos/video_request.rb
|
376
|
-
- lib/facebookads.rb
|
377
|
-
homepage: https://github.com/facebook/facebook-ruby-ads-sdk
|
18
|
+
files: []
|
19
|
+
homepage: https://github.com/facebook/facebook-ruby-business-sdk
|
378
20
|
licenses:
|
379
21
|
- Nonstandard
|
380
22
|
metadata: {}
|
381
|
-
post_install_message:
|
23
|
+
post_install_message: This gem has been deprecated in favor of the updated facebookbusiness
|
24
|
+
gem. Please migrate to the facebookbusiness gem and this gem will be removed from
|
25
|
+
rubygems.org by July 2023
|
382
26
|
rdoc_options: []
|
383
27
|
require_paths:
|
384
28
|
- lib
|
@@ -393,9 +37,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
393
37
|
- !ruby/object:Gem::Version
|
394
38
|
version: '0'
|
395
39
|
requirements: []
|
396
|
-
|
397
|
-
|
398
|
-
signing_key:
|
40
|
+
rubygems_version: 3.1.6
|
41
|
+
signing_key:
|
399
42
|
specification_version: 4
|
400
|
-
summary:
|
43
|
+
summary: "[Deprecated] Please use facebookbusiness gem instead"
|
401
44
|
test_files: []
|
data/LICENSE.txt
DELETED
@@ -1,17 +0,0 @@
|
|
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.
|
data/README.md
DELETED
@@ -1,222 +0,0 @@
|
|
1
|
-
# Facebook Ads API SDK for Ruby
|
2
|
-
|
3
|
-
## Pre-requisites
|
4
|
-
### Ruby Version
|
5
|
-
We developed this SDK using Ruby 2.0, and supports Ruby 2.0+, however, the SDK is not thread-safe at the moment.
|
6
|
-
|
7
|
-
### App
|
8
|
-
To get started with the SDK you must have a Facebook app registered on [developers.facebook.com](https://developers.facebook.com).
|
9
|
-
|
10
|
-
**IMPORTANT**: Enable all migrations in the App's Settings->Migrations page.
|
11
|
-
|
12
|
-
**IMPORTANT**: To have better security, we recommend you to turn on 'App Secret Proof for Server API calls' in your app's Settings->Advanced page.
|
13
|
-
|
14
|
-
## Installation
|
15
|
-
The SDK is available as a RubyGem. To use the gem, you can add the following to Gemfile
|
16
|
-
|
17
|
-
```ruby
|
18
|
-
gem 'facebookads'
|
19
|
-
```
|
20
|
-
|
21
|
-
or install it using command line
|
22
|
-
|
23
|
-
```bash
|
24
|
-
gem install facebookads
|
25
|
-
```
|
26
|
-
|
27
|
-
and then in your code
|
28
|
-
|
29
|
-
```ruby
|
30
|
-
require 'facebook_ads'
|
31
|
-
```
|
32
|
-
|
33
|
-
|
34
|
-
## Configuration
|
35
|
-
### Access Token
|
36
|
-
There are several ways to configure access token and app secret. If you only use one access token and app secret (example: an internal app managing only your own assets). You can set a global access token and app secret will will be used across all requests
|
37
|
-
|
38
|
-
```ruby
|
39
|
-
FacebookAds.configure do |config|
|
40
|
-
config.access_token = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
|
41
|
-
config.app_secret = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
|
42
|
-
end
|
43
|
-
```
|
44
|
-
|
45
|
-
Another way is to configure using environment variables, which will be picked up by the SDK as the default
|
46
|
-
|
47
|
-
```bash
|
48
|
-
FB_ACCESS_TOKEN=asdsadasds
|
49
|
-
FB_APP_SECRET=asdasdsa
|
50
|
-
```
|
51
|
-
|
52
|
-
Or you can create a session object for particular object
|
53
|
-
|
54
|
-
```ruby
|
55
|
-
# Create a Session object to be reused
|
56
|
-
session = FacebookAds::Session.new(access_token: <ACCESS_TOKEN>, app_secret: <APP SECRET>)
|
57
|
-
ad_account = FacebookAds::AdAccount.get('act_12334', 'name', session)
|
58
|
-
|
59
|
-
# Or a using shortcut during object instantiation
|
60
|
-
ad_account = FacebookAds::AdAccount.get('act_12334', 'name', {
|
61
|
-
access_token: <ACCESS_TOKEN>, app_secret: <APP SECRET>
|
62
|
-
})
|
63
|
-
```
|
64
|
-
|
65
|
-
## Basic Operations
|
66
|
-
|
67
|
-
### Reading a node
|
68
|
-
The SDK contains ad object files auto generated from our API metadata, each node type has its own corresponding Ruby class under the `FacebookAds` module. For example, to fetch an AdAccount
|
69
|
-
|
70
|
-
```ruby
|
71
|
-
ad_account = FacebookAds::AdAccount.get('act_1234567', 'name')
|
72
|
-
puts "Ad Account Name: #{ad_account.name}"
|
73
|
-
```
|
74
|
-
|
75
|
-
The `#get` method doesn't trigger the `GET` request immediately. The API request for `GET` is fired on-demand. In the example above, API request won't fire until `ad_account.name` is executed.
|
76
|
-
|
77
|
-
### Updating a node
|
78
|
-
To update a node, you can use the `#save` method of ad object classes.
|
79
|
-
|
80
|
-
```ruby
|
81
|
-
ad_account = FacebookAds::AdAccount.get('act_1234567', 'name')
|
82
|
-
ad_account.name = "New Ad Account"
|
83
|
-
ad_account.save
|
84
|
-
|
85
|
-
# Fetch it again
|
86
|
-
ad_account.reload!
|
87
|
-
ad_account.name
|
88
|
-
=> "New Ad Account"
|
89
|
-
```
|
90
|
-
|
91
|
-
### Deleting a node
|
92
|
-
To delete a node, you can use the `#destroy` method.
|
93
|
-
|
94
|
-
```ruby
|
95
|
-
campaign = FacebookAds::Campaign.get('<CAMPAIGN_ID>')
|
96
|
-
campaign.destroy
|
97
|
-
```
|
98
|
-
|
99
|
-
### Reference
|
100
|
-
You can refer to our [Marketing API reference](https://developers.facebook.com/docs/marketing-api/reference/) or look inside `lib/facebook_ads/ad_objects` directory of the code base to see the complete list of available ad objects.
|
101
|
-
|
102
|
-
## Interacting with Edges
|
103
|
-
|
104
|
-
To interact with an edge, you first need to instantiate the parent node. Since, as mentioned above, `GET` request of a node is triggered on-demand, so you don't need to worry about consuming unnecessary API quota.
|
105
|
-
|
106
|
-
### Fetching Edges (GET)
|
107
|
-
|
108
|
-
Iterating edges is easy, instantiate the parent nodes and then simply iterate with `#each`. The edge is an `Enumerable` so a bunch of handy methods such as `#map`, `#select`, `#find` etc. come for free!
|
109
|
-
|
110
|
-
```ruby
|
111
|
-
ad_account = FacebookAds::AdAccount.get('act_1234567', 'name')
|
112
|
-
|
113
|
-
# Printing all campaign names
|
114
|
-
ad_account.campaigns(fields: 'name').each do |campaign|
|
115
|
-
puts campaign.name
|
116
|
-
end
|
117
|
-
|
118
|
-
# Getting all campaign names
|
119
|
-
ad_account.campaigns(fields: 'name').map(&:name)
|
120
|
-
|
121
|
-
```
|
122
|
-
|
123
|
-
### Creating new nodes (POST)
|
124
|
-
To `POST` to a edge, you can use the `#create` method on the edge and supply parameter if needed
|
125
|
-
|
126
|
-
```ruby
|
127
|
-
campaign = ad_account.campaigns.create({
|
128
|
-
name: "My First campaign",
|
129
|
-
objective: "CONVERSIONS",
|
130
|
-
})
|
131
|
-
```
|
132
|
-
|
133
|
-
### Removing from edge (DELETE)
|
134
|
-
To `DELETE` an edge, you can use the `#destroy` method on the edge and supply parameter if needed
|
135
|
-
|
136
|
-
```ruby
|
137
|
-
# Deleting an AdImage by its hash
|
138
|
-
ad_account.adimages.destroy({hash: 'abcd1234'})
|
139
|
-
```
|
140
|
-
|
141
|
-
## Images/Videos
|
142
|
-
The SDK supports image/video uploads. Just supply a parameter of `File` type.
|
143
|
-
|
144
|
-
Image upload example:
|
145
|
-
|
146
|
-
```ruby
|
147
|
-
# AdImage supports multiple images upload
|
148
|
-
ad_account.adimages.create({
|
149
|
-
'logo1.png' => File.open('./assets/logo1.jpg'),
|
150
|
-
'logo2.png' => File.open('./assets/logo2.jpg'),
|
151
|
-
})
|
152
|
-
=> [#<FacebookAds::AdImage {:hash=>"..."}>, #<FacebookAds::AdImage {:hash=>"..."}>]
|
153
|
-
```
|
154
|
-
|
155
|
-
Video upload example:
|
156
|
-
|
157
|
-
```ruby
|
158
|
-
ad_account.advideos.create({
|
159
|
-
name: 'My first video',
|
160
|
-
source: File.open(File.expand_path("../video_ad_example.mp4", __FILE__))
|
161
|
-
})
|
162
|
-
```
|
163
|
-
|
164
|
-
## Batch API
|
165
|
-
|
166
|
-
[Batch API](https://developers.facebook.com/docs/marketing-api/asyncrequests) allows you to make API calls in a batch. You can collect a bunch of API requests and fire them all at once to reduce wait time. To create a batch, just wrap operations with a block to `FacebookAds::Batch#with_batch`
|
167
|
-
|
168
|
-
```ruby
|
169
|
-
ad_account = FacebookAds::AdAccount.get('act_<ACT_ID>')
|
170
|
-
|
171
|
-
batch = FacebookAds::Batch.with_batch do
|
172
|
-
10.times.map do |n|
|
173
|
-
ad_account.campaigns.create({
|
174
|
-
name: 'My Test Campaign #' + n,
|
175
|
-
objective: 'CONVERSIONS',
|
176
|
-
status: 'PAUSED',
|
177
|
-
})
|
178
|
-
end
|
179
|
-
end
|
180
|
-
|
181
|
-
batch.execute
|
182
|
-
```
|
183
|
-
|
184
|
-
### Dependencies within a batch (Experimental)
|
185
|
-
Dependencies between requests is supported, the SDK simplifies the use of JSONPath references between batched operations.
|
186
|
-
|
187
|
-
```ruby
|
188
|
-
ad_account = FacebookAds::AdAccount.get('act_12334')
|
189
|
-
|
190
|
-
batch = FacebookAds::Batch.with_batch do
|
191
|
-
# This won't be sent out immediately!
|
192
|
-
campaign = ad_account.campaigns.create({
|
193
|
-
name: 'My Test Campaign',
|
194
|
-
objective: 'CONVERSIONS',
|
195
|
-
status: 'PAUSED',
|
196
|
-
})
|
197
|
-
|
198
|
-
# Even the request above is not being sent yet, reference to campaign.id still works
|
199
|
-
ad_accounts.adsets.create({
|
200
|
-
name: 'My AdSet',
|
201
|
-
campaign_id: campaign.id, # campaign.id here will return {result=create-campaign:$.id}
|
202
|
-
...
|
203
|
-
...
|
204
|
-
...
|
205
|
-
})
|
206
|
-
end
|
207
|
-
```
|
208
|
-
|
209
|
-
## Logging
|
210
|
-
|
211
|
-
```ruby
|
212
|
-
FacebookAds.configure do |config|
|
213
|
-
# Logger for debugger
|
214
|
-
config.logger = ::Logger.new(STDOUT).tap { |d| d.level = Logger::DEBUG }
|
215
|
-
|
216
|
-
# Log Http request & response to logger
|
217
|
-
config.log_api_bodies = true
|
218
|
-
end
|
219
|
-
```
|
220
|
-
|
221
|
-
## Reporting Bugs/Feedback
|
222
|
-
Please raise any issue on GitHub.
|