G Suite Business customers can preview App Maker. Ask your domain admin to apply for early access.

Directory model

With the Directory model, your app can get information about users in your organization, such as:

  • Get account information about users.
  • Autocomplete names and email addresses with the User Picker widget people.
  • Display user photos.
  • Get the account IDs of signed-in app users.
  • Get managers and organizational structures of employees.

Requirements

Before you can use Directory with your apps, you need to verify with your G Suite administrator that Administrative APIs are enabled. These APIs are on by default and are required if your organization uses Google Cloud Directory Sync or G Suite Password Sync.

Add a Directory model to your app

You can add a Directory model to any app.

  1. Hover over Data and click add to add a model.
  2. Click Connect an external database and select Directory.
  3. Click Next.
  4. Give the Directory model a name and click Create.
  5. (Optional) Edit the fields of the Directory model. You can change how fields are displayed and drag them to edit their sort order.

User fields and query operators

The Directory’s benefits depends on the quality and accuracy of the data in your organization’s Google Cloud Directory. At a minimum, it should contain first and last names, and email addresses.

Minimum fields

Fields App Maker query operators
GivenName equals
contains
startsWith
FamilyName equals
contains
startsWith
PrimaryEmail equals
contains
startsWith

Additional fields

If your organization’s Google Cloud Directory includes these fields, your apps can retrieve them.

Fields App Maker query operators
FullName equals
contains
PrimaryPhone
WorkPhones
HomePhones
MobilePhones
PrimaryAddress
HomeAddresses
WorkAddresses
CustomEmail
OrganizationExternalId equals
contains
PrimaryOrganizationTitle
PrimaryOrganizationDescription
PrimaryOrganizationDepartment
PrimaryOrganizationLocation
PrimaryOrganizationCostCenter
ThumbnailPhotoUrl
DirectManagerEmail equals
DirectManagerName