Create aGoogle Apps Scriptthat makes requests to the Directory API.

Quickstarts explain how to set up and run an app that calls aGoogle Workspace API. This quickstart uses asimplified authentication approach that is appropriate for a testingenvironment. For a production environment, we recommend learning aboutauthentication and authorizationbeforechoosing the access credentialsthat are appropriate for your app.

In Apps Script, Google Workspacequickstarts useAdvanced Google services to callGoogle Workspace APIs and handle some details of the authenticationand authorization flow.

Objectives

• Configure the environment.
• Create and configure the script.
• Run the script.

Prerequisites

• A Google Workspace domain withAPI access enabled.
• A Google Account in that domain with administrator privileges.

• Access to Google Drive

Create the script

1. Create a new script in the Apps Script editor by going toscript.google.com/create.
2. Replace the contents of the script editor with the following code:

/** * Lists users in a Google Workspace domain. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list */functionlistUsers(){constoptionalArgs={customer:"my_customer",maxResults:10,orderBy:"email",};if(!AdminDirectory||!AdminDirectory.Users){thrownewError("Enable the AdminDirectory Advanced Service.");}constresponse=AdminDirectory.Users.list(optionalArgs);constusers=response.users;if(!users||users.length===0){console.log("No users found.");return;}// Print the list of user's full name and emailconsole.log("Users:");for(constuserofusers){if(user.primaryEmail){if(user.name?.fullName){console.log("%s (%s)",user.primaryEmail,user.name.fullName);}else{console.log("%s",user.primaryEmail);}}}}

3. Click Save.
4. ClickUntitled project, typeQuickstart, and clickRename.

Configure the script

Enable the Directory API

Open the Apps Script project.

1. ClickEditorcode.
2. Next toServices, click Add a serviceadd .
3. Select Admin Directory APIand clickAdd.

Run the sample

In the Apps Script editor, clickRun.

The first time you run the sample, it prompts you to authorize access:

1. ClickReview permissions.
2. Choose an account.
3. ClickAllow.

The script's execution log appears at the bottom of the window.

Next steps

• Google Apps Script Advanced Services documentation
• Try the Google Workspace APIs in the APIs explorer
• Troubleshoot authentication and authorization issues
• Directory API developer guides
• Directory API reference documentation