Google Workspace

To establish a connection with your Google Workspace, please do the following:
  1. A separate email with the link to set up a password for your GG4L Connect account should be sent to you. Activate your admin account in GG4L School Passport according to instructions from the email.
    Please note: The link for account setup is valid only for 24 hours. If the link has expired, please contact support@gg4l.com and request a new one. 

  2. Sign in to the School Passport.

  3. Click Connect.

  4. Choose the Google Workspace Import application:
  5. On the red error notification, click the link. Alternatively, click Settings > Delivery Config.
  6. On the Delivery Config, click Sign in with Google to authorize access to your Google account. Note: Import Groups as Roster Data (Classes) can be set only during the first configuring of the Google Workspace application.
  7. Google's authorization window will open. Choose your account or fill in the username and password in the corresponding fields, and click Next:
  8. Select checkboxes related to “View organization units on your domain”, “View groups on your domain”, “View organization units on your domain”, “View group subscriptions on your domain” and then click Continue.
    Google workspace_authentification_permissions
  9. Click Save at the bottom right.
  10. At the stage of Schools Mapping, click the Finish Configuration button:

Please let us know once you grant the requested access. If you face difficulties setting up Google Workspace on your own, we will be happy to schedule the call and walk you through the process. 

For the next step, OU Mapping, we highly recommend booking a meeting with the GG4L Customer Support team to walk you through the process.

Set mapping rules

On the Mapping Rules step, you can choose the Google OU's that need to be imported.

Mapping rules

  1. To create a mapping rule, do one of the following:
    • Click New Mapping Rule at the top left.
      New mapping rule
    • On the OU’s tree, find an organization that you want to map and click ➕ New Mapping Rule next to its name.Mapping rules_2
  2. On the Add Mapping Rule page that appears set mapping rules:
    • On the OUs and Groups panel, click Select OU and Groups, and then find and select one or more OUs or Groups that you want to map.
    • On the GG4L Users panel, click Type and select GG4L User. Optional, configure other fields.
      Add mapping rule
  3. When you are complete configuring, click Done.

There are two types of mapping rules that can to be configured to import data from your Google Workspace to the GG4L Connect platform:

  • OU Mapping includes specific or all Classes associated with the school to the corresponding OU Mapping Rule.
  • Group Mapping separates Group Mapping for each Class that needs to be imported.

Monitor your rules

The resulting OU structure will be available for preview on the Raw Mapping Rules tab. Here you can browse and define all existing rules (OU Mapping and Group Mapping).

Mapping

Use Mapping Rules Generator

When you create the first mapping rule, you can use it as a template for other OU with help of the Mapping Rules Generator.

To set Mapping Rules Generator, do the following:

  1. After setting mapping rules, you will receive a notification. At the notification, select Mapping Rules Generator.
    Notification

  2. On the Mapping Rules Generator, set features:
    Generator

    • To select the user types, for which you want to use templates, click Type and select one or more types.
    • Optional. To select the OUs that you want to use in Generator, click Set Base DN. On the page that appears, select one or more OUs and sub-OUs for which you want to use templates, and click Done. By default, the tree root is selected.
    • Optional. To add exception items for which you don't want to apply Generator, click Set Exclusion list. On the dialog that appears, select one or more OUs from the dropdown, and click Done.
    • To select schools, for which you want to apply the Mapping Rules Generator, click the School box and select the school from the list.
  3. Click Generate.