AdWords adapter
===============

Classes in the ``ppc_robot_lib.adwords`` module wraps the official ``googleads`` library and provides more
developer-friendly API. These classes contains report definitions for all reports and are able to normalize
the values into values directly usable in Python and Pandas.

The report definitions are currently valid against the ``v201809`` API version.

The report reference can be found in `the official AdWords documentation <https://developers.google.com/adwords/api/docs/appendix/reports/v201705/all-reports>`_.

Values in the downloaded report are converted to proper internal representation. For instance, all enumerables are
converted to Python enums, and all money values are converted from "micros" to base units (e.g. EUR).

The same conversion applies to values sent to the API, which means that you can simply specify value in EUR when
filtering by ``Cost``.

The reports definitions can be re-generated using the following command:


.. code-block:: bash

   ppc_robot adwords_generate_report_classes --out ppc_robot_lib/adwords/reports


.. toctree::
   :maxdepth: 2
   :caption: Contents:

   query