facebookmarketing-python 0.1.5

API wrapper for Facebook written in Python

# facebookmarketing-python

facebookmarketing is an API wrapper for Facebook written in Python

## Installing
```
pip install facebookmarketing-python
```

## Usage
```
from facebookmarketing.client import Client

client = Client('APP_ID', 'APP_SECRET', 'v2.10')
```

Get authorization url
```
url = client.authorization_url('REDIRECT_URL', ['manage_pages'])
```

Exchange the code for an access token
```
token = client.exchange_code('REDIRECT_URL', 'CODE')
```

Extend a short-lived access token for a long-lived access token
```
token = client.extend_token('SHORT-LIVED TOKEN')
```

Get app token
```
token = client.get_app_token()
```

Inspect a token
```
info = client.inspect_token('INPUT TOKEN', 'APP TOKEN')
```

Set the access token
```
client.set_access_token('TOKEN')
```

Get account information
```
account = client.get_account()
```

Get account pages
```
pages = client.get_pages()
```

Get forms given the page
```
forms = client.get_ad_account_leadgen_forms('PAGE_ID')
```

Get leads given the form
```
leads = client.get_ad_leads('FORM_ID')
```

## Requirements
- requests

## Tests
```
python tests/test_client.py
```

## TODO Endpoints
- Ad Creative
- Image Ad
- Previews
- Ad Preview Plugin
- Ad Set
- Ad User
- Ad Video
- Campaign
- Connection Objects
- Currencies
- Image Crop
- Product Catalog


## Contributing
We are always grateful for any kind of contribution including but not limited to bug reports, code enhancements, bug fixes, and even functionality suggestions.

#### You can report any bug you find or suggest new functionality with a new [issue](https://github.com/GearPlug/facebookmarketing-python/issues).

#### If you want to add yourself some functionality to the wrapper:
1. Fork it ( https://github.com/GearPlug/facebookmarketing-python )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Adds my new feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request