1. Support Center
  2. HealthSmart
  3. Google Classroom Integration

Admin Guide: Configuration for Google Classroom

This article explains how to install and configure the HealthSmart integration with the Google Classroom Learning Management System (LMS).

The following configuration guidelines are to be used by district/school IT administrators.

In this article you can find step-by-step instructions for setting up and installing the HealthSmart integration with Google Classroom:


What You Need To Get Started

  • A district/school subscription to the HealthSmart integrated digital edition.
  • District/school IT has submitted the Integration Setup Form to ETR and/or scheduled an integration setup call with the ETR Support team.
  • District/school IT has confirmed installing either Version 1 or Version 2 of the HealthSmart integration with Google Classroom (details below).

Warning The HealthSmart integration with Google Classroom cannot be installed by individuals or teachers. For questions about the setup, please contact ETR Support.


Integration Versions

ETR offers two versions of the HealthSmart integration with Google Classroom. Please review the following technical requirements to confirm which version to install.

Version 1: HealthSmart OAuth Integration
Version 2: HealthSmart Add-On Integration

    Setup Instructions for Version 1

    See the following instructions to begin the setup to the HealthSmart integration for Google Classroom using Google Education Fundamentals (no cost).

    Step 1: Confirm Google Administrator Access

    You must be a Google Administrator to complete the integration process. To confirm that you're a G Suite Administrator, visit the Google Admin Console. If you are an admin, you will have access to the App Access Control page, see example below:

    Google Workspace Updates: Update design for the Admin console home page

    If you do not see the above page and cannot log into this link with your school Google credentials, you will need to have an administrator with additional privileges perform the integration.

    Step 2: Adding the HealthSmart App to the District.

    1. Login to your Google Workspace Admin Console using your administrator credentials.
    2. From the Admin Console dashboard, click on Security in the left-side menu. Select the option > Access And Data Control > API controls. 
      Security > Access and data control
    3. From the API controls, click on Manage Third Party App Access.

      Manage Third Party App Access
    4. Select the option, Configure new app.

      Configure new app
    5. In the dialog box, you will be prompted to enter the Client ID for the app. Please use the HealthSmart application with the following Client ID:
    6. Click on the Search button to find the HealthSmart app.
    7. Once the app has been authorized, select the HealthSmart application from the list of authorized apps and click on Add.
    8. In the Add OAuth app control dialog box, select the appropriate access level for the app.
    9. Click on the Add button to add the app control to the list of authorized apps.

    Optional Step: Add ETR to Allow List

    Sign in to your Google Admin console using your administrator account.

    In the Admin console, go to Menu

    Click Account > Domains > Allowlisted domains
    Click Add domain
    Enter the domains:

    www.etr.org
    etr.org
    healthsmartk12.org
    www.healthsmartk12.org

    Click Add
    Click Save

    Once added to the allowlist and you will be able to grant access to apps and services from that domain as needed. It may prompt to for the level of access, select Trust.

    Step 3: Test the Integration

    ETR will provide a unique launch link connected to the district/school subscription. The launch link authenticates the teacher by logging in to the HealthSmart program website using the teacher's school-assigned Google credentials (see example launch link below). 

    Example Launch Link

    Test the integration by using a teacher account. The launch link will bring the teacher to the HealthSmart sign-in page for Google Classroom. 

    Google Classroom Sign-In Page

    After logging in to Google Classroom, educators are automatically redirected to the HealthSmart website to the welcome page under Lessons. The lower part of the page shows the grade levels of HealthSmart that are included in your subscription.

    Welcome to HealthSmart

    Step 4: Distribute the Launch Link to Teachers

    Each district/school may choose the best way to distribute the launch link to their educators. One option is to distribute the launch link via email with instructions on how to bookmark it in a browser. Another option is to add the launch link to an SSO portal such as Clever or ClassLink by creating a custom link/app.

    If the district/school is adding the launch link to a portal such as Clever or ClassLink, please download the following image file to use as the HealthSmart icon:

    HealthSmart Logo

    Final Confirmation: Congratulations, you’re all set! Please schedule a 10-minute call with us where ETR will create and provide your launch link as well as run a test launch of HealthSmart. This will verify the correct integration setup and initiate the data sync. To schedule the setup call, please contact ETR Support.

    📑Notes:

    • The HealthSmart integration for Google Classroom is configured for teachers only.
    • Students can only access content assigned by a teacher.
    • District/school administrators or other staff will need a course in Google Classroom to access the program. Alternatively, admin access to HealthSmart can be created without the need for a course in Google Classroom. To request this option, please contact ETR Support.

    Setup Instructions for Version 2

    See the following instructions to begin the setup to the HealthSmart integration for Google Classroom using Google Education Plus (paid), or with a purchase of Google’s Teaching and Learning upgrade that has been applied to relevant educators.

    Step 1: Confirm Google Administrator Access

    You must be a Google Administrator to complete the integration process. To confirm that you're a G Suite Administrator, visit the Google Admin Console, see example below:

    Google Workspace Updates: Update design for the Admin console home page

    If you do not see the above page and cannot log into this link with your school Google credentials, you will need to have an administrator with additional privileges perform the integration.

    Step 2: Install the HealthSmart Add-On

    1. Confirm you are logged in to your Google Workspace Admin Console using your administrator credentials.
    2. Visit the HealthSmart Add-On page in the Google Marketplace: https://workspace.google.com/marketplace/app/healthsmart/163032669570 
      • HealthSmart Add-On in Google Marketplace
    3. Click to Install the Add-On, then Continue on the popup that appears.
    4. Choose whether to have HealthSmart available to everyone in Google Classroom or specific groups only.
      • If you select specific groups, you will be asked to specify which groups to grant access to HealthSmart.
    5. Once confirmed, click Finish.

    Step 3: Confirm the Install and Submit Form

    1. Complete our Integration Setup Form to let us know the Add-On has been installed and to initiate the data sync between Google Classroom and your HealthSmart subscription.
    2. Once we receive your form submission, ETR will send an email notifying you that the HealthSmart setup is complete and to test the integration before sharing with educators.

    Step 4: Test the Integration

    1. Please test access to the HealthSmart Add-On Integration with a teacher account.
    2. Log in to a teacher account that has access to the HealthSmart Add-On. Select a course, go to the Coursework tab, then click the + Create button and start a new assignment.
    3. On the Assignment page, HealthSmart will appear under Add-ons (see example below).
      • HealthSmart Add-On from Assignment
    4. Clicking on the HealthSmart Add-On opens a window to the program. Click on View Lessons to start on the welcome page under Lessons. The lower part of the page shows the grade levels of HealthSmart that are included in your subscription.

    Starting HealthSmart

     

    Welcome to HealthSmart

    Final Confirmation: Congratulations, you’re all set! Please contact ETR Support for any questions or concerns related to your integration setup with Google Classroom.

    📑Notes:

    • The HealthSmart integration for Google Classroom is configured for teachers only.
    • Students can only access content assigned by a teacher.
    • District/school administrators or other staff will need a course in Google Classroom to access the program. Alternatively, admin access to HealthSmart can be created without the need for a course in Google Classroom. To request this option, please contact ETR Support.

    Additional Content Control Settings

    HealthSmart allows school districts the autonomy for local decision-making to ensure all lessons align to state and local policies. A district administrator can be assigned content control settings to select the lessons they want educators to use while opting out of any lessons that don’t fit their scope and sequence.

    To use content control settings, a district administrator can be assigned the Lesson Selector Tool which provides a toggle switch to turn on/off lesson access for all educators. See example below:

    The Lesson Selector Tool is only enabled by ETR support. To request using the Lesson Selector Tool, please share the name and title of the district administrator during the HealthSmart setup, or submit your request by contacting ETR Support.

    📑Note: The district administrator will need teacher permissions in the LMS in order to use the Lesson Selector Tool. Teacher permissions in the LMS are handled by district IT.