From d25547e1b91e330dca1ec8adea2cb45ba5154384 Mon Sep 17 00:00:00 2001 From: Tim Swast Date: Mon, 25 Mar 2019 08:50:27 -0700 Subject: [PATCH] DOC: Add privacy policy for pandas GBQ (#264) This is required for verification of the OAuth 2.0 consent screen. --- docs/source/howto/authentication.rst | 1 + docs/source/index.rst | 1 + docs/source/privacy.rst | 45 ++++++++++++++++++++++++++++ 3 files changed, 47 insertions(+) create mode 100644 docs/source/privacy.rst diff --git a/docs/source/howto/authentication.rst b/docs/source/howto/authentication.rst index 4612bc4b..20b0674a 100644 --- a/docs/source/howto/authentication.rst +++ b/docs/source/howto/authentication.rst @@ -76,6 +76,7 @@ See the `Getting started with authentication on Google Cloud Platform `_ guide for more information on service accounts. +.. _authentication-user: Authenticating with a User Account ---------------------------------- diff --git a/docs/source/index.rst b/docs/source/index.rst index e05900b0..caadd795 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -40,6 +40,7 @@ Contents: api.rst contributing.rst changelog.rst + privacy.rst Indices and tables diff --git a/docs/source/privacy.rst b/docs/source/privacy.rst new file mode 100644 index 00000000..cb59a1a9 --- /dev/null +++ b/docs/source/privacy.rst @@ -0,0 +1,45 @@ +Privacy +======= + +This package is a `PyData project `_ and is subject to +the `NumFocus privacy policy `_. Your +use of Google APIs with this module is subject to each API's respective +`terms of service `_. + +Google account and user data +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Accessing user data +~~~~~~~~~~~~~~~~~~~ + +The :mod:`pandas_gbq` module accesses your Google user account, with +the list of `scopes +`_ that you +specify. Depending on your specified list of scopes, the credentials returned +by this library may provide access to other user data, such as your email +address, Google Cloud Platform resources, Google Drive files, or Google +Sheets. + +Storing user data +~~~~~~~~~~~~~~~~~ + +By default, your credentials are stored to a local file, such as +``~/.config/pandas_gbq/bigquery_credentials.dat``. See the +:ref:`authentication-user` guide for details. All user data is stored on +your local machine. **Use caution when using this library on a shared +machine**. + +Sharing user data +~~~~~~~~~~~~~~~~~ + +The pandas-gbq library only communicates with Google APIs. No user +data is shared with PyData, NumFocus, or any other servers. + +Policies for application authors +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Do not use the default client ID when using the pandas-gbq library +from an application, library, or tool. Per the `Google User Data Policy +`_, your +application must accurately represent itself when authenticating to Google +API servcies.