diff --git a/CHANGELOG.rst b/CHANGELOG.rst
index 54154f6..183eec6 100644
--- a/CHANGELOG.rst
+++ b/CHANGELOG.rst
@@ -14,6 +14,8 @@ Version 0.19.1
 
 - Fixed crash when operating on Google Contacts. :gh:`994`
 - The ``HTTP_PROXY`` and ``HTTPS_PROXY`` are now respected. :gh:`1031`
+- Instructions for integrating with Google CalDav/CardDav have changed.
+  Applications now need to be registered as "Web Application". :gh:`975`
 - Various documentation updates.
 
 Version 0.19.0
diff --git a/docs/config.rst b/docs/config.rst
index 080420c..9b1ecd6 100644
--- a/docs/config.rst
+++ b/docs/config.rst
@@ -287,7 +287,7 @@ Service to hardcode those into opensource software [googleterms]_:
    be a searchbox where you can just enter those terms.
 
 3. In the sidebar, select "Credentials" and create a new "OAuth Client ID". The
-   application type is "Other".
+   application type is "Web application".
 
    You'll be prompted to create a OAuth consent screen first. Fill out that
    form however you like.
@@ -305,7 +305,7 @@ or write anything to it.
 .. note::
 
     You need to configure which calendars Google should offer vdirsyncer using
-    a rather hidden `settings page
+    a secret `settings page
     <https://calendar.google.com/calendar/syncselect>`_.
 
 .. storage:: google_calendar
@@ -345,6 +345,10 @@ or write anything to it.
    :param client_id/client_secret: OAuth credentials, obtained from the Google
                                    API Manager.
 
+The current flow is not ideal, but Google has deprecated the previous APIs used
+for this without providing a suitable replacement. See :gh:`975` for discussion
+on the topic.
+
 Local
 +++++