# Common Issues in Google Workspace Integration

1. While integrating Google Workspace with the Hexnode console, an error message Invalid Input appears.
-------------------------------------------------------------------------------------------------------

![](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Google-Workspace-Invalid-Input-FAQ-e1737712621896.png)
### Possible Cause

- This could happen if any of the steps went wrong while configuring Google Workspace.

### Solution

Go through the steps and ensure that the below-mentioned ones are carried out properly.

- **JSON file** is downloaded from the corresponding **Service account** in [Google Developers Console](https://console.developers.google.com/).
- **Service Account Admin** is chosen as the **Service Account role**.
- **Enable Google Workspace Domain-wide Delegation** option under the created Service Account is checked.
- Ensure that **APIs and services** are enabled.
- In the **[Google Admin Console](https://admin.google.com/)**, ensure that API clients are correctly authorized. (Syncing the users and user groups)

While integrating with Hexnode console,

- Ensure that the Google Workspace account’s Admin email is provided.
- A proper **Domain name** is provided.
- The correct **JSON file** is uploaded.
- The correct **Token** is provided.

Once these details are provided, the integration will be completed automatically.

2. On integrating Google Workspace with Hexnode console, an error stating Google Workspace domain names could not be retrieved appears 
---------------------------------------------------------------------------------------------------------------------------------------

[![Error while integrating Google Workspace with Hexnode - Google Workspace domain names could not be retrieved](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Domain-name-error-FAQ-e1737713065403.png "Google Workspace domain names could not be retrieved")](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Domain-name-error-FAQ-e1737713065403.png)

### Cause

Except for the primary domain, the sub-domains and users in the sub-domains are unable to synchronize with the Hexnode UEM portal.

### Reason

The error indicating that Google Workspace domain names could not be retrieved may occur due to two possible reasons:

1. The OAuth scopes for the API client do not include domain specification.
    Since a Google Workspace account can have multiple domains, the users belonging to all the different domains are synchronized only if the domain scope is specified while managing access to the API client.
2. If the added Google Workspace account does not have the necessary admin privileges to retrieve domain details.

### Solution

Include the domain scope for the API client from the Google Admin Console.

1. Log in to [Google Admin Console](https://accounts.google.com/ServiceLogin/webreauth?continue=https%3A%2F%2Fadmin.google.com%2F%3Fpli%3D1&authuser=0&passive=3600&flowName=GlifWebSignIn&flowEntry=ServiceLogin).
2. Navigate to **Security > API Controls > MANAGE DOMAIN WIDE DELEGATION > Domain wide delegation** .
3. Identify your API client from the list. Click **Edit**.
[![Modify settings for API client](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2021/06/Identify-the-API-client.png "Identify the API client")](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2021/06/Identify-the-API-client.png)

5. Copy and paste the following link in the field OAuth scopes: https://www.googleapis.com/auth/admin.directory.domain
6. Click **Authorize**.
[![Include the domain scope for API client](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2021/06/specify-domain-scope-for-API-client.png "specify domain scope for API client")](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2021/06/specify-domain-scope-for-API-client.png)

8. Next, log in to the Hexnode UEM console.
9. Navigate to **Admin > Google Workspace**.
10. Click on the **Refresh Domain** button and click **Save**.

It refreshes the domain and syncs the user information from the sub-domains also.

The required admin privileges for the Google Workspace account can be granted using two methods:

- Assign super admin role

1. Log in to [Google Admin Console](https://accounts.google.com/ServiceLogin/webreauth?continue=https%3A%2F%2Fadmin.google.com%2F%3Fpli%3D1&authuser=0&passive=3600&flowName=GlifWebSignIn&flowEntry=ServiceLogin).
2. Navigate to the **Users** section.
3. Click on the user’s name from the list of users.
4. Go to **Admin roles and privileges**.
5. Toggle the **Super Admin** role to **Assigned** by clicking the slider.
6. Click **Save** to apply the changes.

[![Assigning super admin role to the admin account in Google Admin console.](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Assigning-super-admin-role-in-Google-Admin-console.png)](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Assigning-super-admin-role-in-Google-Admin-console.png "Assigning super admin role in Google Admin console")

- Create a custom admin role with the required admin privileges

1. Log in to [Google Admin Console](https://accounts.google.com/ServiceLogin/webreauth?continue=https%3A%2F%2Fadmin.google.com%2F%3Fpli%3D1&authuser=0&passive=3600&flowName=GlifWebSignIn&flowEntry=ServiceLogin).
2. On the Google Admin console, navigate to **Menu > Account > Admin roles**.
3. Click on **Create new role**.
4. Enter a **name** and, optionally, a **description** for the role and click **Continue**.
5. Select the desired privileges, such as **Domain Settings** and **Domain Management**, from the **Privilege Name** list by checking the appropriate boxes.
6. Click **Continue** to proceed.
7. Review the selected privileges and click **Create Role**.
8. Assign the custom role to the user.

[![Create custom role settings to be configured in Google Admin console.](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Create-custom-role-setting-in-Google-Admin-console-e1737969394715.png)](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Create-custom-role-setting-in-Google-Admin-console-e1737969394715.png "Create custom role setting in Google Admin console")

3. ChromeOS devices listed under the Manage tab shows “N/A” with an error “Could not fetch the user from Google. To find out why, click on Learn more.”
-------------------------------------------------------------------------------------------------------------------------------------------------------

### Cause

The annotated user of the ChromeOS device has not been synced with Hexnode UEM.

### Reason

During the initial enrollment process, each ChromeOS device is assigned to a user in Google Workspace. In Google Workspace, users are organized under specific domains. When integrating Google Workspace with Hexnode UEM, you have the option to sync only selected domains. If the domain that includes the user associated with a particular ChromeOS device is not included among the synced domains from Google Workspace, the user field corresponding to that device will display “N/A” in the *Manage* tab of the Hexnode UEM console.

### Solution

Check the domain of the user assigned to the ChromeOS device.

1. Log in to the [Google Admin Console](https://admin.google.com/).
2. Navigate to **Devices > Chrome > Devices** to view all the devices added to your organization.
3. Click on the required device for a detailed overview.

Once the user’s domain is confirmed, you have two options to resolve the issue:

1. Change the user associated with the device: 
    1. From the device overview page, Click **Edit** under **General > Custom fields**.
    2. Modify the **User** field by selecting a user whose domain is synced with the Hexnode UEM console.
    
    [![Modify annotated user for ChromeOS device in Google Admin Console to a domain synced with Hexnode UEM](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2025/03/Edit-annotated-user-for-ChromeOS-device-in-Google-Admin-Console.png "Edit annotated user for ChromeOS device in Google Admin Console")](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2025/03/Edit-annotated-user-for-ChromeOS-device-in-Google-Admin-Console.png)
2. Sync the respective domain of the current user with the Hexnode UEM console: 
    1. Login to the Hexnode UEM console.
    2. Navigate to **Admin > Google Workspace > Actions > Modify**.
    3. Select the required domain from the list of domains. If it’s not listed, click **Refresh domains**.
    4. Click **Save**.

4. While generating token from Google Admin Console, Control Panel Error #1000 appears.
---------------------------------------------------------------------------------------

### Solution

Following are the two primary solutions:

- Try clearing browser cache.
- Run the website in incognito mode.

If the above solutions don’t work, try with the following secondary solution:

- Login to [Google Admin Console](https://admin.google.com/).
- From the main menu, navigate to **Apps > Additional Google Services**.
    
    ![Additional Google Services settings in Google Admin Console ](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/12/Additional-Google-Services-Settings.png)
- Click on **Add Services**.
    ![Adding Android management service package](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/12/Add-Service-package.png)
- Click on **Add it now** under the **Android Management services** package.
- Once the package is added, you’ll be redirected to **Security > Manage EMM provider for Android > Generate Token**.
- Token will now be generated successfully.

5. After configuring Google Workspace on the Hexnode portal, “Google Workspace could not be configured, ensure that necessary OAuth scopes are provided” error message is shown.
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[![Necessary OAuth scopes error message is displayed in the Hexnode portal after Google Workspace is configured.](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Necessary-OAuth-scopes-error-FAQ-e1737713046476.png)](https://cdn.hexnode.com/mobile-device-management/help/wp-content/uploads/2019/07/Necessary-OAuth-scopes-error-FAQ-e1737713046476.png "Necessary OAuth scopes error")

### Possible Causes

This could happen if:

- Any of the OAuth scopes are missing while configuring Google Workspace.
- Admin SDK is not enabled.

### Solution

Ensure the necessary scopes are added correctly under the **SHOW DOMIN-WIDE DELEGATION** dropdown menu in your Google Admin account.

1. https://www.googleapis.com/auth/admin.directory.user
2. https://www.googleapis.com/auth/admin.directory.group
3. https://www.googleapis.com/auth/admin.directory.domain

If the issue still persists even after adding the correct OAuth scopes, check if the Admin SDK is enabled for the corresponding account. You can enable the Admin SDK by following the steps below:

1. Sign in to your [Google Admin Account](https://admin.google.com).
2. Head over to **Security > API reference**.
3. Check the **Enable API access** option.
4. Press **Save**.

6. “Your sign-in settings don’t meet your organization’s 2-Step Verification policy. Contact your admin for more info.” error message during DEP enrollment.
------------------------------------------------------------------------------------------------------------------------------------------------------------

### Possible Causes

- **2-Step Verification** is enforced on users from the Google Admin console but is not set up in the user account. As a result, such users will be locked out of their accounts when their active sessions expire.
- **2-Step Verification** method is set up as **Only security key** in the Google Admin console, and consequently, the users have configured a built-in security key for verifying their accounts. During DEP enrollment, if the user tries to authenticate using this built-in security, it can lead to an error. Since the DEP enrollment has a Safari-based web view, built-in security keys compatible only with the Chrome browser cannot be used as a method of 2-factor authentication.

### Precautions

- Notify the users and ensure that they have set up 2-step verification in their account before enforcing the same from the Google Admin console. Users can activate the 2-step verification by following the steps below: 
    1. Open [Google Account](https://myaccount.google.com/).
    2. Select **Security** from the navigation menu.
    3. Select **2-Step verification** under **Signing in to Google**.
    4. Click on **Get started** and follow the on-screen instructions.
- Administrators can review [Account reports](https://support.google.com/a/answer/4580176) or check [2-Step Verification Settings](https://support.google.com/a/answer/2537800?product_name=UnuFlow&visit_id=637925997637894337-659684551&rd=1&src=supportwidget0#:~:text=Check%202-Step%20Verification%20settings) to find the users who have set up security keys before enforcing the 2-step verification method.

### Solutions

- Administrators can recover user accounts by generating backup codes: 
    1. Log in to the [Google Admin console](https://admin.google.com/).
    2. Go to **Users** and select the user account you intend to recover.
    3. Navigate to **Security** > **2-step verification**.
    4. Click on **Get Backup Verification Codes** and copy one of the verification codes.
    5. Send this code to the user.
    6. Users can sign in to their account using a password and this backup code.
- Refer to [recovering accounts protected by 2-step verification](https://support.google.com/a/answer/9176734) for additional best practices.

7. After configuring Google Workspace on the portal and syncing the domains, user sync stays in ‘In Progress’ for a long time 
------------------------------------------------------------------------------------------------------------------------------

### Possible Causes

The issue occurs when there are a lot of users (domains) in the directory. 
### Solutions

User syncing will be completed in 5-10 mins once sync is initiated. 
8. After configuring Google Workspace on the Hexnode portal,” Failed Sync” error is shown.
------------------------------------------------------------------------------------------

### Possible Causes

User and/or group scope was not provided. 
### Solutions

Ensure User and group scopes are added before configuring Google Workspace. If the scope to sync groups is not provided, it shows “Sync failed” in the table after configuration. This sync failure does not mean users are not synced, but groups could not be synced.