Skip to content

Google Calendar

The Google Calendar integration allows you to connect your Google Calendar to Mini Dock. This integration displays calendar events in the app and supports notifications.

Prerequisites

You need to configure developer credentials to allow Mini Dock to access your Google Account. The current recommended approach is to create Web Auth credentials for Google Calendar since the same credentials work for all Google integrations. Previously, this integration only supported Device Auth and those credentials are no longer recommended. You can continue to use Device Auth credentials but they will only work with Google Calendar.

Scenario 1: You already have credentials

In this case, all you need to do is enable the API:

  1. Go the Google Developers Console Google Calendar API.
  2. Confirm the project and Enable the API.
  3. Continue with the steps described in the Configuration section.

Scenario 2: You do not have credentials set up yet

In this case, you need to generate a client secret first:

This section explains how to generate a client ID and client secret on Google Developers Console.

  1. First, go to the Google Developers Console to enable Google Calendar API.
  2. Select Create project, enter a project name (such as Mini Dock), and select Create.
  3. Enable the Google Calendar API.

  4. Navigate to APIs & Services (left sidebar) > Credentials.

  5. If you haven't created a project yet, click Create project to create a project, if you have already created a project, skip this step.

  6. Set the project name, such as Mini Dock.

  7. Click Create.

  8. In the left sidebar, select OAuth consent screen.

  9. Select Get started.
  10. Set the App name (the name of the application asking for consent) to anything you want, e.g., Mini Dock.
  11. You then need to select a Support email.
  12. From the dropdown menu, select your email address.

  13. Under Audience, select External.

  14. In Contact Information, Under Developer contact information, enter your email address (the same as above is fine).

  15. In the Finish section, check: User Data Policy. Then click Create to complete the app creation.

  16. Click on Audience in the sidebar and under Publishing status, select Publish app.

    • Otherwise your credentials will expire every 7 days.

  17. Make sure Publishing status is set to In production.

  18. Select Clients, then select Create client (at the top of the screen).

  19. Set the Application type to Web application and give this credential set a name (like "Mini Dock Client").
  20. Add https://redirect.myvobot.com/redirect/oauth to Authorized redirect URIs then select Create.
    • This is not a placeholder. It is the URI that must be used.
  21. You will then be presented with a pop-up saying OAuth client created, showing Your client ID and Your client secret.
    • Make a note of these (for example, copy and paste them into a text editor), as you will need them shortly.
    • Once you have noted these strings, select OK.
    • If you need to find these credentials again at any point, then navigate to APIs & Services > Credentials, and you will see Mini Dock Credentials (or whatever you named them in the previous step) under OAuth 2.0 Client IDs.
    • To view both the Client ID and Client secret, select the pencil icon. This will take you to the settings page for these credentials, and the information will be on the right-hand side of the page.
  22. Congratulations! You are now the keeper of a client secret. Guard it in your treasure box. In most cases your new credentials will be active within a few moments. However, Google states that activation may take up to five hours in some circumstances.

Configuration

To add Google Calendar to your Mini Dock, follow these steps:

  1. Go to the Mini Dock's Web Application Settings page.

  2. Click the login button.

  3. Enter the application credentials (OAuth Client ID and Client Secret).

  4. Follow the steps to select the account you want to authorize.(It is recommended to keep the client account consistent with the login account, otherwise the Google Calendar API may experience exceptions)

  5. After authorization, you'll be directed to an interim login page. Rest assured, this page only transmits data over the local network and saves it to your device. Please configure your device's IP on this page.

  6. Click "Link" to return to the Mini Dock's Web Application Settings page. At this point, you can continue with the remaining configuration or proceed to use the application.

Troubleshooting

  1. Error 400: redirect_uri_mismatch when logging in

    • Error cause: The redirect_uri does not match the Authorized redirect URIs set in Google Developers Console.
    • Solution: Check if the Authorized redirect URIs in Google Developers Console includes https://redirect.myvobot.com/redirect/oauth.

  2. Error 400: invalid_grant when logging in

    • Error cause: The client ID and client secret do not match.
    • Solution: Verify that the client ID and client secret are correct.

  3. "Error: invalid client credentials" appears in the web settings interface

    • Error cause: The client ID and client secret do not match.
    • Solution:
      1. Verify that the client ID and client secret are correct.
      2. Create a new client.