CLN: remove deprecated google-analytics module (GH11308) (pandas-dev#…

…15223)

doc/source/remote_data.rst

@@ -29,63 +29,3 @@ modules to be independently updated to your pandas installation. The API for
    .. code-block:: python
 
       from pandas_datareader import data, wb
-
-
-.. _remote_data.ga:
-
-Google Analytics
-----------------
-
-The :mod:`~pandas.io.ga` module provides a wrapper for
-`Google Analytics API <https://developers.google.com/analytics/devguides>`__
-to simplify retrieving traffic data.
-Result sets are parsed into a pandas DataFrame with a shape and data types
-derived from the source table.
-
-Configuring Access to Google Analytics
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The first thing you need to do is to setup accesses to Google Analytics API. Follow the steps below:
-
-#. In the `Google Developers Console <https://console.developers.google.com>`__
-    #. enable the Analytics API
-    #. create a new project
-    #. create a new Client ID for an "Installed Application" (in the "APIs & auth / Credentials section" of the newly created project)
-    #. download it (JSON file)
-#. On your machine
-    #. rename it to ``client_secrets.json``
-    #. move it to the ``pandas/io`` module directory
-
-The first time you use the :func:`read_ga` function, a browser window will open to ask you to authentify to the Google API. Do proceed.
-
-Using the Google Analytics API
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The following will fetch users and pageviews (metrics) data per day of the week, for the first semester of 2014, from a particular property.
-
-.. code-block:: python
-
-    import pandas.io.ga as ga
-    ga.read_ga(
-        account_id  = "2360420",
-        profile_id  = "19462946",
-        property_id = "UA-2360420-5",
-        metrics     = ['users', 'pageviews'],
-        dimensions  = ['dayOfWeek'],
-        start_date  = "2014-01-01",
-        end_date    = "2014-08-01",
-        index_col   = 0,
-        filters     = "pagePath=~aboutus;ga:country==France",
-    )
-
-The only mandatory arguments are ``metrics,`` ``dimensions`` and ``start_date``. We strongly recommend that you always specify the ``account_id``, ``profile_id`` and ``property_id`` to avoid accessing the wrong data bucket in Google Analytics.
-
-The ``index_col`` argument indicates which dimension(s) has to be taken as index.
-
-The ``filters`` argument indicates the filtering to apply to the query. In the above example, the page URL has to contain ``aboutus`` AND the visitors country has to be France.
-
-Detailed information in the following:
-
-* `pandas & google analytics, by yhat <http://blog.yhathq.com/posts/pandas-google-analytics.html>`__
-* `Google Analytics integration in pandas, by Chang She <http://quantabee.wordpress.com/2012/12/17/google-analytics-pandas/>`__
-* `Google Analytics Dimensions and Metrics Reference <https://developers.google.com/analytics/devguides/reporting/core/dimsmets>`_

doc/source/whatsnew/v0.15.2.txt

@@ -163,7 +163,7 @@ Other enhancements:
      p.all()
 
 - Added support for ``utcfromtimestamp()``, ``fromtimestamp()``, and ``combine()`` on `Timestamp` class (:issue:`5351`).
-- Added Google Analytics (`pandas.io.ga`) basic documentation (:issue:`8835`). See :ref:`here<remote_data.ga>`.
+- Added Google Analytics (`pandas.io.ga`) basic documentation (:issue:`8835`). See `here<http://pandas.pydata.org/pandas-docs/version/0.15.2/remote_data.html#remote-data-ga>`__.
 - ``Timedelta`` arithmetic returns ``NotImplemented`` in unknown cases, allowing extensions by custom classes (:issue:`8813`).
 - ``Timedelta`` now supports arithemtic with ``numpy.ndarray`` objects of the appropriate dtype (numpy 1.8 or newer only) (:issue:`8884`).
 - Added ``Timedelta.to_timedelta64()`` method to the public API (:issue:`8884`).

doc/source/whatsnew/v0.20.0.txt

@@ -351,6 +351,8 @@ Removal of prior version deprecations/changes
 - The ``pandas.rpy`` module is removed. Similar functionality can be accessed
   through the `rpy2 <https://rpy2.readthedocs.io/>`__ project.
   See the :ref:`R interfacing docs <rpy>` for more details.
+- The ``pandas.io.ga`` module with a ``google-analytics`` interface is removed (:issue:`11308`).
+  Similar functionality can be found in the `Google2Pandas <https://github.com/panalysis/Google2Pandas>`__ package.
 - ``pd.to_datetime`` and ``pd.to_timedelta`` have dropped the ``coerce`` parameter in favor of ``errors`` (:issue:`13602`)