Google Settings
Google Settings allow ERPNext to connect with Google services using OAuth 2.0 authentication or an API key, depending on the service being integrated.
Services such as Google Calendar, Google Contacts, Google Drive, and Google Indexing use OAuth 2.0, while Google Maps requires an API key for supported features.
1. Supported Google Integrations
- Google Calendar
- Google Contacts
- Google Drive
- Google Indexing
- Google Maps
2. Configure Google Services Using OAuth 2.0
To synchronize data with Google services, ERPNext must be authorized through Google’s OAuth 2.0 authentication protocol.
Step 1: Create a Google Cloud Project
- Create a new project in Google Cloud Platform.
- Generate OAuth 2.0 credentials for the project.
Step 2: Enable the Required API
Enable the API corresponding to the service you want to integrate.
- Google Calendar — Calendar API
- Google Contacts — People API
- Google Drive — Drive API
- Google Indexing — Indexing API
Step 3: Create OAuth Credentials
- Open API & Services > Credentials.
- Create a new OAuth Client ID.
- Select Web Application as the application type.
Step 4: Configure Authorized URLs
Add the following URLs while configuring the OAuth client:
Authorized JavaScript Origin
https://{yoursite}
Redirect URI for Google Calendar
https://{yoursite}?cmd=frappe.integrations.doctype.google_calendar.google_calendar.google_callback
Redirect URI for Google Contacts, Google Drive, and Google Indexing
https://{yoursite}/api/method/frappe.integrations.google_oauth.callback
Step 5: Configure ERPNext
Copy the generated Client ID and Client Secret into the Google Settings page in ERPNext.
3. Configure Google Maps
Google Maps integration uses an API key instead of OAuth authentication.
An API key is required only for features that use the Directions API, such as Delivery Trip. Other Google Maps features do not require this configuration.
Steps
- Create or open a Google Cloud project.
- Generate a new API Key.
- Enable the Directions API in the API Library.
- Enter the generated API Key in Google Settings within ERPNext.