Definition

The "Find Manager" action retrieves the manager of a specified user within Google Directory. It allows you to look up and identify the manager associated with a given user account. This action is particularly useful when you need to determine the hierarchy within an organization, manage access controls based on managerial roles, or automate notifications and tasks requiring knowledge of employee-manager relationships.

Key Capabilities:

• Retrieve detailed information about a user’s manager.
• Option to choose between the administrator-only or domain-wide public view of the user’s data.
• Supports input via user’s unique ID, email address, or primary email.
• Outputs key user information such as job title, last login, and relationship details.

Example Use Cases

1. Employee Hierarchy Management

   Use this action to automate organizational hierarchy tracking by retrieving the manager for each employee. It helps you understand reporting structures and manage groupings based on managerial oversight.

2. Access Control and Permissions

   Use this action to determine the manager of a user for role-based access control. You can restrict or grant permissions to resources based on the user's manager, improving security by following the principle of least privilege.

3. Automated Notifications

   Automatically send notifications to a user’s manager when specific conditions are met, such as a new hire, a policy change, or other key events. This action helps streamline communication without manual intervention.

4. Reporting and Analytics

   Fetch manager information to run reports on employee distribution by manager. This can be useful for reporting on workloads, employee performance, or team structure analysis within the organization.

5. Employee Onboarding and Offboarding

   During onboarding or offboarding processes, you may need to gather manager information to assign tasks, transfer responsibilities, or remove access. This action simplifies the retrieval of managerial details to ensure smooth transitions.

Inputs

1. Connection

   This refers to the connection to the Google Directory service. You must configure the connection in your application to allow interaction with Google Directory API. It’s the gateway through which all actions are executed. Ensure you have valid credentials and permission to access the directory.

2. Id or Email of the User

   This is the identifier for the user whose manager you want to find. You can provide the user's primary email address, alias email address, or unique user ID.

   • Example:
     • Primary Email: [email protected]
     • Alias Email: [email protected]
     • Unique User ID: 1234567890 This is the key field that determines the user for whom you will retrieve the manager information.

3. Information to Return

   This field determines what information you want to fetch regarding the user and their manager. You can choose between:

   • Domain Public View: Provides general user information available to the domain.
   • Admin View: Provides more detailed information available only to administrators, such as internal metadata or other restricted data. Choose the appropriate level of information based on the privacy requirements or the specifics of your use case.

**Outputs **

The Find Manager action retrieves detailed information about the user’s manager as well as the user's own profile information. Here’s a deep dive into each of the output fields:

1. User ID

   A unique identifier assigned to each user within the Google Directory system. This ID is used to identify the user in API requests. The User ID can be used in further queries to fetch specific details related to the user or their manager.

   Example: 1234567890

2. User Primary Email

   The primary email address associated with the user’s account. This is the main point of contact and is typically the user’s login email.

   Example: [email protected]

3. Name

   This field returns the user’s name, broken down into components. It can include:

   • Given Name: The first name of the user (e.g., “John”).
   • Family Name: The last name of the user (e.g., “Doe”).
   • Full Name: A combination of the first and last names (e.g., “John Doe”). Example: John Doe

4. Job Title

   This field returns the user’s job title, such as “Software Engineer” or “Marketing Manager.” This is helpful for understanding the user’s role within the organization.

   Example: Software Engineer

5. Is Admin

   Indicates if the user has super administrator privileges within Google Workspace. Super admins have full control over the organization’s Google services and settings.

   Example: True (if the user is an admin) or False (if the user is not an admin).

6. Is Delegated Admin

   This field indicates whether the user has delegated admin rights. Delegated administrators have specific administrative privileges but are not full super admins. They can perform certain actions like managing groups, users, or devices but with restricted scope compared to super admins.

   Example: True (if the user is a delegated admin) or False (if the user is not a delegated admin).

7. Last Login Time

   The timestamp when the user last logged into their Google account. This information helps track activity and determine the recency of a user’s login.

   Example: 2025-03-09T15:45:30Z

8. Created Time

   This is the timestamp when the user's account was originally created in the Google Directory.

   Example: 2020-01-15T08:00:00Z

9. Agreed to Terms

   Indicates whether the user has completed the initial login and accepted the terms of service agreement.

   Example: True (if the user has agreed to the terms) or False (if the user has not agreed).

10. Suspended

    This field indicates whether the user’s account is suspended. A suspended user cannot log in or perform any actions until the suspension is lifted.

    Example: True (if the user is suspended) or False (if the user is active).

11. Archived

    Indicates if the user's account has been archived. Archived accounts are typically inactive and removed from active usage but still exist for historical record.

    Example: True (if the user is archived) or False (if the user is not archived).

12. Change Password at Next Login

    This indicates whether the user is required to change their password during their next login.

    Example: True (if password change is required) or False (if no change is required).

13. IP Whitelisted

    Indicates whether the user’s IP address is whitelisted, allowing them to access their Google account from specific, approved IP addresses.

    Example: True (if the user’s IP is whitelisted) or False (if it is not).

14. Emails

    A list of all email addresses associated with the user, including primary and alias addresses. This is useful to find alternate ways to contact the user.

15. Phones

    A list of phone numbers associated with the user. These could include personal and business phone numbers.

16. External IDs

    A list of external IDs associated with the user, such as an employee or network ID. This can be helpful for integrating with external systems or databases.

17. Relations

    A list of the user’s relationships to other users. For example, it can show if the user is a manager, a direct report, etc.

    Example:

    • Manager of: Jane Smith
    • Direct report of: John Doe

18. Organizations

    This lists the organizations the user is associated with. It can help identify which groups or departments the user belongs to.

19. Aliases

    A list of the user's alias email addresses. These are alternative email addresses that are linked to the user's primary email account.

20. Non-Editable Aliases

    A list of the user’s non-editable alias email addresses. These are usually external email addresses that cannot be modified by the user or admins within the Google Admin Console.

21. Customer ID

    The unique ID for the customer’s account in Google’s Admin system. This can be used to filter or query specific data for an individual customer.

    Example: C00000000

22. Parent Org Path

    The full path of the parent organizational unit associated with the user. This helps to place the user within the correct structure of the organization.

    Example: /corp/sales/marketing

23. Is Mailbox Setup

    Indicates whether the user’s mailbox is set up in Google Workspace. A user without a mailbox cannot receive emails through Google’s email services.

    Example: True (if the mailbox is set up) or False (if not).

24. 2SV Enrolled

    Indicates whether the user is enrolled in Two-Step Verification (2SV), which adds an extra layer of security to their account.

    Example: True (if enrolled) or False (if not enrolled).

25. 2SV Enforced

    Indicates whether Two-Step Verification (2SV) is enforced for the user. If enforced, the user must use 2SV to access their account.

    Example: True (if enforced) or False (if not enforced).

26. Global Address List

    Indicates whether the user’s profile is visible in the global address list for the domain, making it accessible to all domain members.

    Example: True (if visible) or False (if not visible).

27. Addresses

    A list of physical addresses associated with the user, such as the user’s home or office address.

28. Locations

    A list of locations related to the user, such as office locations or regions the user is responsible for.

    Example:

    • New York, USA
    • London, UK

29. Hash Function

    Stores the hashed format of the user’s password. This is used for authentication systems that store passwords securely.

    Example:

    • SHA-256
    • MD5

30. Gender

    A nested object containing the user’s gender information. This field provides demographic details about the user.

31. Notes

    A custom field where administrators can add notes or comments about the user.

32. Recovery Email

    The recovery email address that can be used to regain access to the account if the user forgets their password or is locked out.

    Example: [email protected]

33. Recovery Phone

    The recovery phone number associated with the user’s account. This can be used for account recovery in case the user is unable to access their account.

    Example: `+165066612

12`

34. Deletion Time

    The timestamp when the user’s account was deleted. This field is useful for auditing purposes or understanding when a user was removed from the system.

    Example: 2025-01-15T17:30:04+01:00

35. Languages

    A list of languages the user speaks or uses. This can be useful for personalization and providing localized services.

36. Websites

    A list of the user’s websites or online presences, such as personal or professional websites.

37. Keywords

    A field that allows administrators to add any specific keywords related to the user for easier searching and organization.

---

These outputs provide a comprehensive view of the user’s details, along with any relevant managerial or organizational information. Depending on the settings chosen (Admin or Domain Public View), you’ll get more or less access to these fields.

Example of Using

Scenario:
Imagine an HR administrator needs to identify the manager of a user in the company to inform them about an important update regarding the user’s department. The HR admin can use the Find Manager action to quickly retrieve the manager’s details based on the user’s email address.

Step-by-step Example:

1. The HR admin wants to contact the manager of Jane Smith, whose primary email is [email protected].
2. The admin inputs the User's Email ([email protected]) in the action’s input field.
3. The action returns detailed information about Jane Smith’s manager, including:
   • The manager's name, email, and job title (e.g., John Doe - Director of Sales).
   • Additionally, the admin can view other user information, such as whether the manager is an admin, their last login time, and more.
4. The HR admin now has the necessary contact details to send an email or schedule a meeting with John Doe, Jane’s manager, to discuss the updates.

This action streamlines the process of finding a manager for a given user, enhancing communication and workflow management.