> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goguardian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshoot Google OU Sync Issues

> Steps to resolve Google Organizational Unit import errors and fix students listed in the wrong OU in GoGuardian.

This article covers troubleshooting steps for Google Organizational Unit (OU) import issues, including errors when attempting to sync and students not listed in the correct OU.

## Fix OU Import Errors

If the Google Admin Console OU import or sync process fails, administrators may see an error message stating the OU import failed.

The primary cause of import errors is Google account permissions and API or security settings in Google Admin Console.

### 1. Verify Google Account Permissions

Syncing or importing OUs from Google requires the following Google account permissions:

* Admin API Privileges:
  * Domain Management
  * Organization Units (create, read, update, delete)
  * Users (create, read, update, delete)

Check and edit account permissions in the **Admin roles and privileges** section of Google Admin Console.

<Note>
  If there is only 1 OU for the domain, importing the OU structure to GoGuardian isn't necessary. Multiple OUs allow for greater control over access to student data for administrator accounts and are used for granular filtering and reviewing activity features in GoGuardian Admin and Beacon.
</Note>

If account permissions are correct, verify that there is more than 1 OU in the OU structure.

### 2. Configure API Access

Verify access to the GoGuardian OAuth App in Google Admin Console.

1. In the Google Admin Console Dashboard, go to **Security**, then **Access and Data Control**, then **API Controls**.

2. From the API access control page, select **Manage Third-Party App Access**.

3. Click **Configure new app**. In the search bar, enter "GoGuardian" and click **Search**. From the search results, look for the following OAuth Client ID:

   `1022294148666-393p05kvfint8elhvpn7dlle48gopg1j.apps.googleusercontent.com`

4. Select the **All users** option or scope to specific org units.

5. Set the app to **Trusted**, click **Continue**, then click **Finish** on the final page.

If you continue to have trouble with OU imports, contact the GoGuardian Support team.

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-01.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=660226f51944f695d78556cb52d43e22" alt="GoGuardian. Oops, it looks like this OU import failed! GoGuardian engineers have been alerted and will look into the…" width="1908" height="1072" data-path="images/screenshots/troubleshoot-ou-import/step-01.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-02.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=9651aea2447366d0f53c7c825aff5c62" alt="Fix OU Import Errors" width="1320" height="308" data-path="images/screenshots/troubleshoot-ou-import/step-02.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-03.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=9e3a565b3d2f04d3150cc4f713dfc09e" alt="Google Admin dashboard menu: Security (selected), Access and data control (selected), API controls (selected)" width="1300" height="1070" data-path="images/screenshots/troubleshoot-ou-import/step-03.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-04.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=6c4cdbec2a0ae3d857c6f9c753b314f2" alt="Fix OU Import Errors" width="2100" height="1164" data-path="images/screenshots/troubleshoot-ou-import/step-04.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-05.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=c1f093642c2cf9ed460da7ba851260c1" alt="Fix OU Import Errors" width="2022" height="1112" data-path="images/screenshots/troubleshoot-ou-import/step-05.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-06.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=9860598dd0365579ce8a333972743e5c" alt="Fix OU Import Errors" width="2132" height="852" data-path="images/screenshots/troubleshoot-ou-import/step-06.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-07.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=9fde27c206044fc1587e5b06379d73ea" alt="Fix OU Import Errors" width="2092" height="1348" data-path="images/screenshots/troubleshoot-ou-import/step-07.png" />

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-08.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=d753c4a8541c42574121302a15e82128" alt="Fix OU Import Errors" width="568" height="158" data-path="images/screenshots/troubleshoot-ou-import/step-08.png" />

## Fix Students Listed in the Wrong OU

If a student's Organizational Unit displays only a forward slash ("/"), this typically means the OU that the student belongs to in Google Admin Console was not chosen to be synced to GoGuardian. When this occurs, the student is placed in the root or domain-level OU.

<Note>
  The root OU can still be filtered by any filtering policies applied at the root level.
</Note>

1. Look up the student in Google Admin Console to confirm their current OU.

2. If the OU is incorrect, click **Change Organizational Unit** and select the correct OU.

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-09.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=fb01a90f7f4c84461bfde24dd4085366" alt="If the OU is incorrect, click Change Organizational Unit and select the correct OU." width="644" height="494" data-path="images/screenshots/troubleshoot-ou-import/step-09.png" />

3. Manually sync Org Units with Google Admin Console in GoGuardian Admin or Org Management.

<img src="https://mintcdn.com/goguardian/uPYkhWpFXSbDhWEe/images/screenshots/troubleshoot-ou-import/step-10.png?fit=max&auto=format&n=uPYkhWpFXSbDhWEe&q=85&s=162c03575d357b3c7067849ae1cb6250" alt="Manually sync Org Units with Google Admin Console in GoGuardian Admin or Org Management." width="956" height="334" data-path="images/screenshots/troubleshoot-ou-import/step-10.png" />

4. Allow up to 5 minutes for updated Organizational Units to display in GoGuardian Admin.

## Understand Automatic Sync

GoGuardian automatically syncs your selected imported OUs once per day. If student accounts are moved between imported OUs in Google Admin Console, or if you add a new student to an imported OU, the updates are reflected in GoGuardian Admin by the next morning.

## Important: Handling OU Structure Changes

Over the course of the year, you might rename, reorganize, add, or delete OUs in Google Admin Console. If your OU structure is modified in Google Admin Console, you must manually re-import or re-sync your OUs to reflect the changes.

<Note>
  After re-importing your OUs, re-evaluate your GoGuardian Admin policies to confirm they're applied appropriately. If there are significant changes to imported OUs, any filtering policies applied to those OUs may be removed.
</Note>

## Resources

<CardGroup cols={2}>
  <Card title="Manage Users and Settings" href="/products/teacher/manage-users-and-settings">
    Review account and permission settings for GoGuardian Teacher.
  </Card>

  <Card title="Set Up Teacher Accounts" href="/products/teacher/set-up-teacher-accounts">
    Get started with teacher account configuration.
  </Card>

  <Card title="Import Teachers from Google Directory" href="/products/teacher/import-teachers-from-google-directory">
    Sync teacher accounts directly from Google Admin Console.
  </Card>

  <Card title="Student Not Found" href="/products/teacher/student-not-found">
    Troubleshoot missing students in GoGuardian Teacher.
  </Card>
</CardGroup>
