Google Ads API (Beta) Adapter
=============================

Module ``ppc_robot_lib.google_ads`` provides a wrapper around the official ``google-ads`` library and allows downloading
the data to a `pandas.DataFrame`. The API can be queried using the `Google Ads Query Language <https://developers.google.com/google-ads/api/docs/query/overview>`_.

The reporting system in the upcoming AdWords API is different from the system in AdWords API. You download attributes
and metrics for individual resources, not from prepared reports. You can combine attributes from multiple resources
in the query, but the metrics and segments are always related to the main resource specified in the `FROM` clause.

The complete list of resources and their attributes can be found `in the official Google Ads API reference <https://developers.google.com/google-ads/api/fields/v2/overview>`_.
The resources are divided into two categories: resources with metrics and resources without metrics.

You can also use `Interactive GAQL Builder <https://interactive-gaql-builder.appspot.com/>`_ to build your queries.

The resource definitions can be updated using the following command:

.. code-block:: bash

    ppc_robot google_ads_generate_resources --service-account-id <ID>

Replace the <ID> with ID of any Google Ads service account from the ``robots_service_accounts`` table. ``1`` is usually
a good choice, because it is the first account that was used to log into PPC Robot.


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

   query