With this integration, institutions can now take advantage of using Single Sign On (SSO), Google Drive, Google Meet and Google Calendar functions from inside Classe365.
To enable this feature follow these steps :
STEP-1: Login to Developer's Console.
Go to https://console.developers.google.com. Login with your Google Workspace or Google Account.
STEP-2: Create Project
Click on "New Project" to add a project.
Select the Project Created and use the button - "Open" to make it selected by default.
STEP-3: Enable API's
Ensuring that you have selected the project that you have just created. Click on "Library", and browse (filter) for API below and enable them.
Enable the following APIs
Calendar API
Picker API
Drive API
Google Classroom API
Example:
Similarly, find the "Calendar API" and enable it for calendar integration.
Google Classroom API to sync Google Assessments and Courses.
To know more about synchronizing courses in Google Classroom to Classe365's LMS use the below button.
STEP-4: Generate API Key
Go to Credentials tab and click on Create Credentials > API Key. Copy the API Key. This will be used later,
Copy the API key generated into another text document, we'll add this to Classe365 Apps Setting later.
After generating the API Key, if you find the warning icon as in the snapshot below, click on the API key.
Update the key restrictions to "Website", and "Add" URL of your domain.
Add your account link, and click "Save".
Ensure, there's a checkmark icon on the API Key.
STEP-5: Generate O-Auth Client ID
Click on Create Credentials > OAuth client ID
If you're creating O-Auth Client ID for the first time, then you need to Configure Consent Screen. Google redirects you to the configure screen button.
Configure Consent Screen
After going into the "Configure Consent Screen" users will be taken to the "branding" section. Let's add our app, click on "Get Started" button.
Overview
App Information
Complete the "App Information" prompts by giving a name to the app you are about to create, and select the "Support Email", click "Next" button.
Audience
Here you'll be asked to select "User Type" you need to choose either "Internal" or "External".
Internal - No verification required, but only the G-Suite emails (user emails) registered in your domain can use the project integration.
External - Emails registered by other domains (external users) can use the integration. Since, a school has users outside the domain, Classe365 recommends enabling this.
You'll have to select "External" for users to access your integration when the users are not in your contacts list.
Contact Information
Enter email addresses that need to get alerts, or notifications on any changes.
Finish
Check the terms and conditions, and click on "Continue".
Clients
Go to "Clients" section, and click on "Create Client".
Create OAuth Client ID
Authorized Javascript Origins
URL 1: https://<your_subdomain>.classe365.com
URL 2: Place your custom URL here if you have enabled White Label
Authorized Redirect URI's should be "https://<your_subdomain>.classe365.com/users/login
For White Label enabled accounts, you can keep both "Classe365 URL" and "White Label URL", so Google SSO works fine in both the URLs.
Click on "Create" after configuring the OAuth Client ID.
Copy Credentials
Now, the Google Console will generate the "Client ID" and "Client Secret". It is important that you copy both to a notepad for later use.
STEP-6: Integrate in Classe365 App Settings
Login to Classe365 as admin and go to the Accounts > Organization Settings.
Apps > Google Apps
Insert the API Key, Client ID and Client Secret copied from Google Apps API Section and enable SSO, Calendar and Google Meet integration. After integrating, complete the remaining steps.
STEP-7: Data Access - Adding Scopes
When you ask users for permission to access their Google Account, Scopes let you specify the types of private data that your project will be able to access.
Go to "Data Access" tab and click on "Add or Remove Scopes"
Add the following scopes:
Google Calendar/Google Meet:
Google Drive:
Google Class Room:
Google SOS Login
Here's a video demo on adding scopes
After adding all the scopes, click on "Save" button, and proceed to the next step.
STEP-8: Branding App
After completing the data access setup, go to Branding tab, and here you'll need to set up your domain branding.
App Domain
Application Home Page - set your Classe365 Homepage.
Application Privacy Policy Link - you'll need to set your website's privacy policy link.
Application Terms of Service - set your terms and services page link from your website here.
Click on "Save" after completing the brand settings.
STEP-9: Publish App
After testing the integration, you can now publish the app.
After publishing the app, you may need to complete certain Google Standards for the app to be published for everyone, click on "Verification Center".
Click on "Prepare for verification" button.
Google may need to have your consent for using scopes in "Data Access" section. Click on "Fix the issue" button.
You'll need to explain on how the scopes are used in your application, an example can be found below:
How will Scopes be used? | The application, Classe365, is a cloud-based Student Information System that integrates with Google Workspace to streamline school administration and learning. We require the following scopes for these essential features:
|
YouTube Video Link |
Here is how you can fix these issues:
Verification Questionnaire
You may be asked the following questions, just set the below responses to Google.
Is your application for personal use only?
No
Is your application for Internal use only?
No
Is your application for Development/Testing/Staging use only?
No
Is your application a Gmail SMTP Plugin only for use by WordPress Site Admin(s)?
No
Acknowledge by checking the checkboxes and submit app for verification.
STEP-10: Verify Account's Home Page URL
Go to Google Search Console > Add a Property, and enter your account URL, and click "Continue".
Google allows you to verify using the following ways:
1) HTML File
Download the "HTML File" by Google, and share it with our support team, we'll upload the HTML file and revert to you.
You'll need to then visit the Google Search Console and verify.
2) HTML Meta Tag
Expand the "HTML Tag", copy the meta tag, and share it with our support team, we'll insert the tag and revert, you'll need to then verify after the tag is inserted.
That's it for now, If you need any help on this please write us to [email protected]