adparlor-facebook 0.5.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 25c8f2e2b346a62b86c650d8b2fdc1b692339416
+  data.tar.gz: f63e094b0eccd481167a8b6fe789271f058f9265
+SHA512:
+  metadata.gz: 815c4f75c9d5ee83f0b728dfaeab0d0ca5d64eae605695db5b3bdfafe975db5fac2b0f2550e378b8d5583b6b5e4d52853ab325df8288dd24ff521bfbe7703559
+  data.tar.gz: f98aeb0de7ab5d0c6ff3bd5abe01822fd639ddf476d52935d914378c41df5b729ccdd803889a31bc6ec72e1f9854898dfb56ec63fe7b3e95b6819dd40d386497

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.DS_Store
+.byebug_history

data/.gitlab-ci.yml

@@ -0,0 +1,5 @@
+specs_master:
+  only: 
+    - master
+  script: 
+    - ./bin/gitlab_runner_specs.sh

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,28 @@
+AllCops:
+  Exclude:
+    - '*.gemspec'
+    - 'spec/vcr/**/*'
+
+Documentation:
+  Enabled: false
+
+Metrics/AbcSize:
+  Enabled: false
+
+Metrics/ClassLength:
+  Max: 125
+
+Metrics/LineLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/RegexpLiteral:
+  Enabled: false
+
+Style/SignalException:
+  Enabled: false

data/.ruby-version

@@ -0,0 +1 @@
+2.3.2

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.1.0
+before_install: gem install bundler -v 1.10.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in adparlor-facebook.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,136 @@
+PATH
+  remote: .
+  specs:
+    adparlor-facebook (0.5.9)
+      faraday
+      faraday_middleware
+      httpclient
+      mime-types
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.6.0)
+      public_suffix (>= 2.0.2, < 4.0)
+    ast (2.4.0)
+    byebug (11.0.1)
+    coderay (1.1.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    faraday (0.15.4)
+      multipart-post (>= 1.2, < 3)
+    faraday_middleware (0.13.1)
+      faraday (>= 0.7.4, < 1.0)
+    ffi (1.10.0)
+    formatador (0.2.5)
+    guard (2.15.0)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.9.12)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-bundler (2.2.1)
+      bundler (>= 1.3.0, < 3)
+      guard (~> 2.2)
+      guard-compat (~> 1.1)
+    guard-compat (1.2.1)
+    guard-rspec (4.7.3)
+      guard (~> 2.1)
+      guard-compat (~> 1.1)
+      rspec (>= 2.99.0, < 4.0)
+    guard-rubocop (1.3.0)
+      guard (~> 2.0)
+      rubocop (~> 0.20)
+    hashdiff (0.3.9)
+    httpclient (2.8.3)
+    jaro_winkler (1.5.2)
+    json (2.2.0)
+    listen (3.1.5)
+      rb-fsevent (~> 0.9, >= 0.9.4)
+      rb-inotify (~> 0.9, >= 0.9.7)
+      ruby_dep (~> 1.2)
+    lumberjack (1.0.13)
+    method_source (0.9.2)
+    mime-types (3.2.2)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2019.0331)
+    multipart-post (2.1.1)
+    nenv (0.3.0)
+    notiffany (0.1.1)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parallel (1.17.0)
+    parser (2.6.3.0)
+      ast (~> 2.4.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    public_suffix (3.0.3)
+    rainbow (3.0.0)
+    rake (10.5.0)
+    rb-fsevent (0.10.3)
+    rb-inotify (0.10.0)
+      ffi (~> 1.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-rerun (1.1.0)
+      rspec (~> 3.0)
+    rspec-support (3.8.0)
+    rubocop (0.69.0)
+      jaro_winkler (~> 1.5.1)
+      parallel (~> 1.10)
+      parser (>= 2.6)
+      rainbow (>= 2.2.2, < 4.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 1.7)
+    ruby-progressbar (1.10.0)
+    ruby_dep (1.5.0)
+    safe_yaml (1.0.5)
+    shellany (0.0.1)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    thor (0.20.3)
+    unicode-display_width (1.6.0)
+    vcr (4.0.0)
+    webmock (3.5.1)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  adparlor-facebook!
+  bundler (~> 1.10)
+  byebug
+  guard
+  guard-bundler
+  guard-rspec
+  guard-rubocop
+  rake (~> 10.0)
+  rspec-rerun
+  simplecov
+  vcr
+  webmock
+
+BUNDLED WITH
+   1.16.2

data/Guardfile

@@ -0,0 +1,13 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rubocop, all_on_start: false do
+  watch(%r{.+\.rb$})
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { 'spec' }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Kel Stopper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,164 @@
+### [![build status](https://gitlab.ak-networks.com/ci/projects/8/status.png?ref=master)](https://gitlab.ak-networks.com/ci/projects/8?ref=master) Master (GitLab CI)
+
+###[![](https://ci.solanolabs.com:443/AdParlor//badges/branches/master?badge_token=b5e0dec703fe9ae000ae346dceb0b7ddd53c91db)](https://ci.solanolabs.com:443/AdParlor/facebook_ruby_ads_sdk/suites/509306) Master (Solano CI)
+
+# Adparlor::Facebook
+
+The adparlor-facebook gem is a ruby library for interacting with the Facebook ads API. Supporting both REST and batch requests.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'adparlor-facebook', git: 'https://gitlab.ak-networks.com/adparlor/facebook_ruby_ads_sdk.git'
+```
+
+or locally for development
+
+```bash
+bundle config local.adparlor-facebook ~/Projects/facebook_ruby_ads_sdk
+```
+
+```ruby
+gem 'adparlor-facebook', branch: 'master'
+```
+
+And then execute:
+
+    $ bundle
+
+<!-- Or install it yourself as:) -->
+
+<!--    $ gem install adparlor-facebook) -->
+
+## Usage
+
+### Graph API
+
+Once an access token is obtained [https://developers.facebook.com/docs/facebook-login/access-tokens](https://developers.facebook.com/docs/facebook-login/access-tokens) you can begin
+making requests to the GraphApi.
+
+```ruby
+#Get an ad account by the id
+account = Adparlor::Facebook::GraphApi::AdAccount.get(account_id, access_token: 'access_token')
+account.name #-> 'the account name'
+account.account_status #-> 'the account status'
+
+#Get an ad creative  by the id
+creative = Adparlor::Facebook::GraphApi::AdCreative.get(creative_id, access_token: 'access_token')
+creative.id #-> '11111111111111111'
+
+#The Get method also takes the fields option like the graph api by default only returning the minimal fields
+creative = Adparlor::Facebook::GraphApi::AdCreative.get(creative_id, access_token: 'access_token', fields: %w(body image_hash image_url ...))
+#OR
+creative = Adparlor::Facebook::GraphApi::AdCreative.get(creative_id, access_token: 'access_token', fields: Adparlor::Facebook::GraphApi::AdCreative.fields(:all))
+creative.id #-> '11111111111111111'
+creative.name #-> 'the creatives name'
+creative.thumbnail_url #-> 'https://facebook.com/image...'
+
+#You can also get objects by their edges as referred to in the Facebook documentation
+#which returns a memoized array of object types.
+account = Adparlor::Facebook::GraphApi::AdAccount.get(account_id, access_token: 'access_token')
+account.adcreatives.all #-> [Adparlor::Facebook::GraphApi::AdCreative<...>, Adparlor::Facebook::GraphApi::AdCreative<...>, Adparlor::Facebook::GraphApi::AdCreative<...>, ...]
+account.adimages.all #-> [Adparlor::Facebook::GraphApi::AdImage<...>, Adparlor::Facebook::GraphApi::AdImage<...>, Adparlor::Facebook::GraphApi::AdImage<...>, ...]
+account.campaigns.all #-> [Adparlor::Facebook::GraphApi::Campaign<...>, Adparlor::Facebook::GraphApi::Campaign<...>, Adparlor::Facebook::GraphApi::Campaign<...>, ...]
+
+#The all method also takes the fields option like the graph api by default only returning the minimal fields
+account.adcreatives.all.first #-> Adparlor::Facebook::GraphApi::AdCreative<@id => '1111111111111111'>
+account.adcreatives.all(Adparlor::Facebook::GraphApi::AdCreative.fields(:all))).first #-> Adparlor::Facebook::GraphApi::AdCreative<@id='1111111111111111', @body='...', @image_hash='...'>
+
+#The edges also implement create and delete options
+account.adimages.delete(hash: '6aec0dd976393abfad84e8f2511960a8') #-> response.body = {"success" => true}
+
+account.adimages.create(source: 'http://www.example.com/url/to/image.png')
+#OR
+account.adimages.create(source: '/path/to/image.png') #-> response.body = :images => { :url => 'https://facebook.com/image/localtion.png', :hash => 'd0f7567af280e1f6760457ff4df782d8' }
+```
+
+### Batch requests
+
+If making large numbers of requests at the same time or requests that depend on each other the batch object can be used.
+```ruby
+#The batch api requires an access token in the case some of the requests use different tokens
+#or one is not supplied for fallback purposes.
+account = Adparlor::Facebook::GraphApi::AdAccount.get(account_id, access_token: 'access_token')
+response = account.batch do |batch|
+  batch.get account.id, AdImage, fields: [:id, :name, :hash] # uses the parent objects token
+  batch.get account.id, Campaign, access_token: account.access_token # uses the parent objects token but it is supplied
+  batch.get account2.id, AdImage, access_token: account2.access_token, fields: [:id, :name, :height]
+end
+response #-> [[AdImage, AdImage, ...],[Campaign, Campaign, ...],[AdImage, AdImage, ...]]
+
+#The object can also be created without an account if the requests are all different accounts or non account level objects
+#This will use the access token of the first object to be the top level access token
+response = Adparlor::Facebook::GraphObject.new.batch do |batch|
+  batch.get nil, AdCreative, id: '6666666666666', access_token: 'access_token'
+  batch.get nil, AdCreative, id: '7777777777777', access_token: 'access_token'
+end
+
+#Posting follows the same style request, files should be accompanied by the source key.
+response = account.batch do |batch|
+  batch.post account.id, AdImage, source: 'http://www.example.com/url/for/image.png' # uses the parent objects token
+  batch.post account2.id, AdImage, source: 'http://www.example.com/url/for/othe-image.png', access_token: account2.access_token # uses its own token
+end
+response #-> [AdImage, AdImage]
+
+#Deleting follows the same style request
+response = account.batch do |batch|
+  batch.delete account.id, AdImage, hash: 'bee06e2e03f9b5a32419855e2c7a4225'
+  batch.delete account.id, AdImage, hash: 'd8ebd0caddecb512ec3b782ae9498e13'
+end
+
+#You can mix up requests
+response = account.batch do |batch|
+  batch.post account.id, AdImage, source: 'http://www.example.com/url/for/image.png'
+  batch.post account2.id, AdImage, source: 'http://www.example.com/url/for/othe-image.png', access_token: account2.access_token
+  batch.get account.id, AdImage, fields: [:id, :name, :hash]
+  batch.get account.id, Campaign
+end
+response #-> [AdImage, AdImage, [AdImage, AdImage, ...],[Campaign, Campaign, ...]]
+
+#You can post requests that are dependent on other requests
+#In this case the post that another post is dependent on will supply a name to the options parameter
+#which is then referred to in dependents posts appropriate column.
+#in this case the campaign post gets the name 'create_campaign' the following request refers to it
+#using the JSONPath expression format required by the batch api '{result=create_campaign:$.id}'
+# for more information visit: https://developers.facebook.com/docs/marketing-api/batch-requests/v2.5
+response = account.batch do |batch|
+  batch.post account.id, Campaign,
+             { name: 'A Test Campaign', objective: 'LOCAL_AWARENESS', status: 'PAUSED' },
+             name: 'create_campaign'
+  batch.post account.id, AdSet,
+             name: 'A Test AdSet', daily_budget: 135, start_time: '00:05:00',
+             campaign_id: '{result=create_campaign:$.id}', bid_amount: 150,
+             billing_event: 'IMPRESSIONS', optimization_goal: 'REACH',
+             targeting: {
+               geo_locations: { cities: [{ key: '2418956', radius: 12, distance_unit: 'mile' }] },
+               page_types: %w(desktopfeed mobilefeed)
+             }, status: 'PAUSED',
+             promoted_object: { page_id: your_page_id }
+end
+response #-> [null, AdSet]
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+<!-- To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org). -->
+
+<!-- ## Contributing -->
+
+<!-- Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/adparlor-facebook. -->
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## TODO
+
+* Create requests should probably return an instance of the object instead of the Faraday body
+* ?Delete requests should return true if deleted or error message?
+* Continue to add endpoints
+* More configurable tests for testing live instead of the vcr cassettes.

data/Rakefile

@@ -0,0 +1,3 @@
+require 'bundler/gem_tasks'
+require 'rspec-rerun/tasks'
+task default: 'rspec-rerun:spec'

data/adparlor-facebook.gemspec

@@ -0,0 +1,38 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'adparlor/facebook/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'adparlor-facebook'
+  spec.version       = Adparlor::Facebook::VERSION
+  spec.authors       = ['Kel Stopper', 'Lukas Beaton']
+  spec.email         = ['kstopper@adparlor.com', 'lbeaton@adparlor.com']
+
+  spec.summary       = 'A ruby implementation of the facebook sdk'
+  spec.description   = 'The adparlor-facebook gem is a ruby library for interacting with the Facebook ads API. Supporting both REST and batch requests.'
+  spec.homepage      = 'http://adparlor.com'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.10'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-bundler'
+  spec.add_development_dependency 'guard-rspec'
+  spec.add_development_dependency 'guard-rubocop'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec-rerun'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'byebug'
+
+  spec.add_dependency 'faraday'
+  spec.add_dependency 'faraday_middleware'
+  spec.add_dependency 'httpclient'
+  spec.add_dependency 'mime-types'
+end

data/bin/console

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'adparlor/facebook'
+
+Adparlor::Facebook.configure do |config|
+  config.api_version = 'v2.5'
+end
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/gitlab_runner_specs.sh

@@ -0,0 +1,22 @@
+#!/bin/sh
+
+printf "\n\nRUNNER SCRIPT: Running as `whoami`"
+printf "\n\nRUNNER SCRIPT: Running in directory `pwd`"
+
+printf "\n\nRUNNER SCRIPT: Environment Variables..."
+printf "\n\n`printenv`"
+
+printf "\n\nRUNNER SCRIPT: Installing Gems...\n"
+source ~/.bash_profile
+rbenv local 2.0.0-p353
+bin/setup
+errcode=$?
+
+if [ "$errcode" != 0 ]
+then
+  printf "\n\nRUNNER SCRIPT: Gem installation failed!"
+  exit $errcode
+fi
+
+printf "\n\nRUNNER SCRIPT: Running specs...\n"
+VCR_RECORD=all bundle exec rake rspec-rerun:spec

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/adparlor/facebook/api.rb

@@ -0,0 +1,106 @@
+require 'faraday'
+require 'faraday_middleware'
+
+module Adparlor
+  module Facebook
+    module MultipleRequestParamsEncoder
+      def self.encode(query_hash)
+        ids_path(query_hash.delete(:ids), query_hash.delete(:fields), query_hash.delete(:access_token))
+      end
+
+      def self.ids_path(ids, fields, access_token)
+        "ids=[#{ids.join(',')}]&fields=#{fields}&access_token=#{access_token}"
+      end
+    end
+
+    module Api
+      def base_uri
+        Adparlor::Facebook.configuration.base_uri
+      end
+
+      def proxy_api_key
+        Adparlor::Facebook.configuration.proxy_api_key
+      end
+
+      def conn
+        Faraday.default_adapter = :httpclient
+        @conn ||= Faraday.new do |faraday|
+          faraday.request :multipart
+          faraday.request :retry, max: 3, exceptions: [Exception]
+          faraday.request :url_encoded
+          faraday.response :json
+          faraday.adapter Faraday.default_adapter
+          faraday.headers['x-api-key'] = proxy_api_key unless proxy_api_key.nil?
+        end
+      end
+
+      def conn_multi
+        @conn_multi ||= Faraday.new(
+          full_url('', {}), request: { params_encoder: Adparlor::Facebook::MultipleRequestParamsEncoder }
+        ) do |faraday|
+          faraday.request :retry, max: 3, exceptions: [Exception]
+          faraday.response :json
+          faraday.adapter Faraday.default_adapter
+          faraday.headers['x-api-key'] = proxy_api_key unless proxy_api_key.nil?
+        end
+      end
+
+      def get(path, options = {})
+        options[:fields] = self.class.fields(*options[:fields]) if options[:fields] && options[:fields].is_a?(Array)
+        raise FbError.new('required parameter access_token missing', 500) unless options[:access_token] || path.include?('access_token')
+        if path.to_s.empty? && options.key?(:ids)
+          conn_multi.get '', options
+        else
+          conn.get full_url(path, options), options
+        end
+      rescue Faraday::ParsingError
+        # FB has returned some data that we can't parse into JSON
+        raise FbError.new("Unable to make request.", 500)
+      end
+
+      def post(path, options = {}, method = 'CREATE')
+        self.class.validate_post_fields(*instance_variables.map { |k| k.to_s.delete('@') }, method) if self.class.respond_to?(:validate_post_fields)
+        raise FbError.new('required parameter access_token missing', 500) unless options[:access_token] || path.include?('access_token')
+        body = instance_variables.each_with_object({}) { |var, hash| hash[var.to_s.sub(/@/, '').to_sym] = instance_variable_get(var) }
+        content_type_header = options.delete(:content_type_header)
+        content_type_header ||= body[:source].respond_to?(:content_type) || !@files.nil? ? 'multipart/form-data' : 'application/json'
+        body.delete(:files)
+        body[:bytes] = Base64.encode64(open(body.delete(:source).io, &:read)) if body.key?(:source)
+        conn.post full_url(path, options) do |request|
+          request.headers['Content-Type'] = content_type_header
+          request.params = options
+          request.body = content_type_header == 'multipart/form-data' ? (@files || {}).merge(body) : body.to_json
+        end
+      rescue Faraday::ParsingError
+        # FB has returned some data that we can't parse into JSON
+        raise FbError.new("Unable to make request.", 500)
+      end
+
+      def delete(path, options = {})
+        raise FbError.new('required parameter access_token missing', 500) unless options[:access_token] || path.include?('access_token')
+        conn.delete full_url(path, options) do |request|
+          request.headers['Content-Type'] = 'application/json'
+          request.params = options
+          request.body = instance_variables.each_with_object({}) { |var, hash| hash[var.to_s.sub(/@/, '').to_sym] = instance_variable_get(var) }.to_json
+        end
+      rescue Faraday::ParsingError
+        # FB has returned some data that we can't parse into JSON
+        raise FbError.new("Unable to make request.", 500)
+      end
+
+      private
+
+      def api_version(options)
+        "/#{options.delete(:api_version) || Adparlor::Facebook.configuration.api_version}/"
+      end
+
+      def full_url(path, options)
+        if URI.parse(path).scheme
+          path
+        else
+          URI.join(base_uri, api_version(options), path.gsub(%r{\A/}, ''))
+        end
+      end
+    end
+  end
+end

data/lib/adparlor/facebook/config.rb

@@ -0,0 +1,24 @@
+module Adparlor
+  module Facebook
+    class << self
+      attr_accessor :configuration
+
+      def configure
+        self.configuration ||= Configuration.new
+        yield configuration
+      end
+    end
+
+    class Configuration
+      attr_accessor :api_version
+      attr_accessor :base_uri
+      attr_accessor :proxy_api_key
+
+      def initialize
+        @api_version = 'v2.5'
+        @base_uri = 'https://graph.facebook.com'
+        @proxy_api_key = nil 
+      end
+    end
+  end
+end

data/lib/adparlor/facebook/error.rb

@@ -0,0 +1,13 @@
+module Adparlor
+  module Facebook
+    class Error < StandardError
+      attr_reader :error_code
+
+      def initialize(message, error_code = nil, error_attributes = {})
+        @error_code = error_code
+        error_attributes.each { |key, value| instance_variable_set("@#{key}".to_sym, value) }
+        super message
+      end
+    end
+  end
+end

data/lib/adparlor/facebook/graph_api/activity.rb

@@ -0,0 +1,11 @@
+module Adparlor
+  module Facebook
+    module GraphApi
+      class Activity < GraphObject
+        include Fields::Activity
+        include Traits::Methods
+        field_attrs FIELDS
+      end
+    end
+  end
+end