sjs/vdirsyncer
1
0
Fork 0
mirror of https://github.com/samsonjs/vdirsyncer.git synced 2026-04-27 14:57:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Slightly improve docs for configuring google

Browse source
This commit is contained in:
Hugo Osvaldo Barrera 2023-07-13 12:34:57 +02:00
parent 1a6ad54543
commit 4237ff863c
2 changed files with 15 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
CHANGELOG.rst
View file

@ -20,6 +20,9 @@ Version 0.19.2
functional impact, and is merely for forward compatibility with the Rust functional impact, and is merely for forward compatibility with the Rust
implementation of vdirsyncer. implementation of vdirsyncer.
- Python 3.10 and 3.11 are officially supported. - Python 3.10 and 3.11 are officially supported.
- Instructions for integrating with Google CalDav/CardDav have changed.
Applications now need to be registered as "Desktop applications". Using "Web
application" no longer works due to changes on Google's side. :gh:`1078`
Version 0.19.1 Version 0.19.1
============== ==============

20
docs/config.rst
View file

@ -287,25 +287,29 @@ Furthermore you need to register vdirsyncer as an application yourself to
obtain ``client_id`` and ``client_secret``, as it is against Google's Terms of obtain ``client_id`` and ``client_secret``, as it is against Google's Terms of
Service to hardcode those into opensource software [googleterms]_: Service to hardcode those into opensource software [googleterms]_:
1. Go to the `Google API Manager <https://console.developers.google.com>`_ and 1. Go to the `Google API Manager <https://console.developers.google.com>`_
create a new project under any name.
2. Create a new project under any name.
2. Within that project, enable the "CalDAV" and "CardDAV" APIs (**not** the 2. Within that project, enable the "CalDAV" and "CardDAV" APIs (**not** the
Calendar and Contacts APIs, those are different and won't work). There should Calendar and Contacts APIs, those are different and won't work). There should
be a searchbox where you can just enter those terms. be a search box where you can just enter those terms.
3. In the sidebar, select "Credentials" and create a new "OAuth Client ID". The 3. In the sidebar, select "Credentials", then "Create Credentials" and create a
application type is "Desktop". new "OAuth Client ID".
You'll be prompted to create a OAuth consent screen first. Fill out that You'll be prompted to create a OAuth consent screen first. Fill out that
form however you like. form however you like.
After setting up the consent screen, finish creating the new "OAuth Client
ID'. The correct application type is "Desktop application".
4. Finally you should have a Client ID and a Client secret. Provide these in 4. Finally you should have a Client ID and a Client secret. Provide these in
your storage config. your storage config.
The ``token_file`` parameter should be a filepath where vdirsyncer can later The ``token_file`` parameter should be a path to a file where vdirsyncer can
store authentication-related data. You do not need to create the file itself later store authentication-related data. You do not need to create the file
or write anything to it. itself or write anything to it.
.. [googleterms] See `ToS <https://developers.google.com/terms/?hl=th>`_, .. [googleterms] See `ToS <https://developers.google.com/terms/?hl=th>`_,
section "Confidential Matters". section "Confidential Matters".