Skip to main content
Skip table of contents

Configure GSuite

Follow the Prerequisites

The GSuite Admin SDK Reports API has several prerequisites, which can be found in the Google Admin SDK Documentation. Most importantly, for access to the Google Admin Console, you need:

  • A Super Administrator account to enable API Access; and
  • An admin account with the Reports Administrator privilege to create and grant permission to the application.

Create a Project

  1. Open the Google API Console:
  2. Open the Select a Project window, and then click New Project.
  3. Give the project a name, such as "demo."

    If you are familiar with Google APIs and projects, you can use an existing project.

  4. (Optional) Edit the Project ID and Organization.
  5. Click Enable APIs and Services.
  6. In the search bar, type Admin SDK.
  7. Click Admin SDK API, and then click Enable.

Create Credentials

  1. Open the Google API Console:
  2. From the top-left menu, select your project (in the example below, "demo."
  3. Click the OAuth Consent Screen tab, select Internal as the User Type, and then click Create.
  4. Enter the App Name, User Support Email, and Developer Contact Information on this page.
  5. Click Save and Continue.
  6. Click Add or Remove Scopes.
  7.  Click on the Filter field, select API, and then select Admin SDK API from the drop-down
  8.  Click on the Filter field again, type Reports, hit enter, and select both of the listed APIsFinally, click on Update to save the scopes.

  9.  Newly added scopes will be shown on the dashboard.  Click Save and Continue. Finally, click on the Credentials option in the left menu.

  10. Open the Create Credentials drop-down menu, and click OAuth client ID.

  11. On the Create OAuth Client ID page, do the following:

    1. For Application type, select Desktop App.
    2. Enter a Name, such as "lr-gsbeat."
    3. Click Create.

      Your OAuth Consent screen config may look different than the screenshot below. Ensure that you fill out all required fields.

  12. The OAuth client window appears with your client ID and client secret.

  13. Copy the client ID and paste it into a text editor. It will be used to configure the app in the workspace admin portal.
  14. To close the popup, click OK.
    The client ID is now populated on the Credentials page.
  15. Download the JSON credentials. You need them to Initialize the GSuite Beat.

Enable API Access

  1. Open the Google Admin console:
  2. On the home page, click Security.
  3. Click API Controls.
  4. Click Manage Third-Party App Access.
  5. Click on Add app, and select OAuth App Name or Client ID.

  6. Paste the Client ID copied in the Create Credentials section, and click Search.

  7. Select OAuth Client ID and the client ID you pasted, then click Select. 
  8. Select the Trusted: Can access all Google services option, and then click Configure.
  9.  Your app is configured to be used, and you can now Initialize the GSuite Beat.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.