Metadata-Version: 1.0
Name: facebookmarketing-python
Version: 0.1.6
Summary: API wrapper for Facebook written in Python
Home-page: https://github.com/GearPlug/facebookmarketing-python
Author: Miguel Ferrer
Author-email: ingferrermiguel@gmail.com
License: GPL
Description: # 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
        
Platform: UNKNOWN
