For Developers

Implementation Details

This document provides an overview of how Edlink's integration with Google Workspace operates, covering user rostering specifics, authentication, and key considerations for successful implementation.

Rostering Details

Edlink pulls user data from Google Workspace to facilitate rostering. This includes importing people (students, teachers, and staff) from the Google Workspace directory. However, unlike Google Classroom or LMS platforms, Google Workspace does not provide class, course, or enrollment data.

How It Works:

  • Edlink synchronizes users from the Google Workspace directory.
  • All users are - Users are imported without roles or class assignments.

Key Considerations

  • Limited Data Scope:
    • Google Workspace only provides user-level data. Information about roles (e.g., teacher, student) or class enrollments is not available.
    • If additional data such as course enrollments is required, consider integrating with Google Classroom.
  • Single Sign-On (SSO) Only:
    • The integration is focused on rostering and SSO. No coursework, assignments, or grading data is available from Google Workspace.
  • Placeholder School Structure:
    • All users are placed under a single placeholder school for simplicity. This may affect reporting or filtering by school if multiple institutions are managed within the same Google Workspace instance.

Recommendations for Common Issues

Here are some tips for resolving frequent issues during the setup and synchronization process.

Missing Users

  • Ensure that all users are part of the Google Workspace directory under the school's domain.
  • Verify that users have active accounts. Suspended or inactive accounts may not sync. `

Authentication Issues

  • Confirm that Google Workspace SSO is enabled for all users and that Edlink is configured as a trusted application.
  • Verify that the primary email addresses in Google Workspace match those in any connected systems to avoid authentication mismatches.

For assistance with setup, validation, or troubleshooting, please contact Edlink support or your Customer Success Manager.