adwords_reports
is a library to quickly and easily receive cross-account reports from Google AdWords.
-
You can install
adwords_reports
usingpip
:$ pip install adwords_reports
or using git
:
`$ pip install git+https://github.com/SaturnFromTitan/adwords_reports.git`
-
Get access to AdWords API and cache all credential information in a .yaml file.
- Google's tutorial for authenticating with their API
- Google's client library for python
- You'll need to pass the path to this file to the Client for authentication:
from adwords_reports import Client credentials_path = "adwords_credentials.yaml" client = Client(credentials_path)
-
Try to run the code in examples/account_hierarchy.py to see if everything is working.
- Have a look at the other examples as well. This is the best place to get you up to speed.
-
For more detailed information on report types, available fields etc. please refer to the Google's official documentation.
- The library currently supports Python 2.7 and 3.5+
- All reports are returned as pandas DataFrames - the standard tool to analyse data in Python
- Tests are written with pytest.
The project was launched and is currently maintained by me, Martin Winkel.
Contributors are very welcome! Just file an issue or pull request.