kidd / org-gcal.el

Org sync with Google Calendar. (active maintained project as of 2019-11-06)
436 stars 47 forks source link

Updated installation instructions #141

Open benthamite opened 3 years ago

benthamite commented 3 years ago

The installation instructions are a bit outdated. The suggested revision below incorporates the changes reported here and here, and makes a few other changes. I also include the corresponding org version as an attachment in case you want to update the readme file. I would suggest that someone test them before making any changes, though, since I haven't myself double-checked everything.

  1. Go to Google Developers Console.

  2. Create a project (with any name and any location).

  3. Click on the project.

  4. Click on the hamburger menu at the upper-left, then APIs & Services, then Credentials.

  5. Click on Configure consent screen, then on Create.

  6. Set up a consent screen. Give the application a name and set it up as type "external application", and accept the defaults for everything else. Then click on Publish.

  7. Click on Create Credentials and Oauth client ID with Application type Desktop-app.

  8. Click on Create Client ID.

  9. Record the Client ID and Client secret for setup.

  10. Under the same APIs & Services menu section, select Library.

  11. Scroll down to Calendar API. Click the Enable button to enable calendar API access to the app you created in steps 5 & 6.

  12. Go to Google setting page and click the gear-shaped settings icon in the upper right, then select "Settings" from the drop down list.

  13. Select the "Setting for my Calendars" tab on the left, which will display a list of your calendars.

  14. Select the calendar you would like to synchronize with. This will take you to the "Calendar Settings" page for that calendar. Near the end is a section titled "Integrate Calendar". At the very beginning of this section, just below the section heading, you should find your Calendar ID displayed.

  15. Copy the Calendar ID for use in the settings below, where you will use it as the first element in the org-gcal-file-alist for associating calendars with specific org files. You can associate different calendars with different org files, so repeat this for each calendar you want to use.

installation.txt

telotortium commented 3 years ago

Thanks! Could you make a pull request so I can review it more easily?