API Provider Setup

To authenticate a Google Calendar element instance you must create a project with a web application in the Google API console, enable the Google Calendar API, and establish OAuth 2.0 credentials. When you authenticate, use the OAuth 2.0 credentials Client ID, Client secret, and Authorized redirect URI as the API Key, API Secret, and Callback URL.

See the latest setup instructions in the Google API documentation.

Locate Credentials for Authentication

If you already created a project and application, follow the steps below to locate the Client ID, Client secret, and Authorized redirect URI. If you have not created an app, see Create an Application.

To find your OAuth 2.0 credentials:

1. Log in to your account at Google.

2. Click Select a project, choose your project from the list, and then click Open.

   Google displays your apps and associated Client ID.

3. Click the pencil icon to see the Client ID, Client secret, and Authorized redirect URI.

4. Record the Client ID and Client secret.

5. Record the Authorized redirect URI for your app.

You must also enable the Google Calendar API. For the steps see Enable Google APIs.

Create an Application

If you have not already created a project and application, you need one to authenticate with Google Calendar.

To create a project and application:

1. Log in to your account at Google.
2. Click Select a project and click the Create Project button.
3. Accept the terms of service.
4. Complete the required information (Project Name, email updates, and the Terms of Service).
5. Click Create.
6. Select the project that you just created
7. Click Enable APIs and Services.
8. Search for and enable the Google Calendar API.
9. Click Credentials on the left menu.
10. Click the OAuth consent screen tab.
11. Enter a Product Name and add any optional information, and then click Save.
12. Click Create Credentials, and then select OAuth Client ID.
13. Select Web application as the Application type.
14. Enter a Name and the Authorized redirect URI for your app. Record this as the OAuth Callback URL that you will need to authenticate.
15. Click Create.
16. Record the Client ID and Client secret to use when you authenticate.

Enable Google APIs

To enable API requests from Cloud Elements or your app to access Google Calendar, you must enable the Google Drive API and the Google Calendar API. If you do not enable the APIs, you might get 403 errors in your response with a providerMessage such as:

{
  "providerMessage": "error - {code=403, message=Google Calendar API has not been used in project ......}"
}

To enable the required Google APIs:

1. On the Dashboard page, click Enable APIs and Services.
2. Search for and enable the Google Calendar API.

Next authenticate an element instance with Google Calendar.