Documentation
Start typing to search…

Update Organizational Unit

Definition

The "Update Organizational Unit" action in the Google Directory category allows administrators to modify an existing Organizational Unit (OU) within their domain. This action enables updating key attributes such as the OU name, parent organizational unit, and description while ensuring proper hierarchy and access control.

Key Capabilities:

  • Modify the name of an existing organizational unit.
  • Reassign an organizational unit to a different parent organizational unit.
  • Update the description to provide better context or details about the unit.
  • Ensure accurate structuring of users and devices within the organization.

This action is particularly useful for businesses that frequently reorganize teams, update department names, or restructure their Google Directory hierarchy.


Example Use Cases

1. Department Name Change

When a department undergoes a rebranding or restructuring, update the Organizational Unit name to reflect the new identity.

2. Moving an Organizational Unit

If a team or department is shifted under a new division, change its parent organizational unit to maintain the correct hierarchy.

3. Adding Context with Descriptions

Enhance clarity by updating the description of an Organizational Unit to specify its function, team members, or purpose.

4. Merging Departments

When two departments merge, reassign an Organizational Unit to a new parent unit and update its name accordingly.

5. Correcting Mistakes in Organizational Structure

Fix errors in the Organizational Unit hierarchy by updating incorrect names or parent units.


**Inputs **

  1. Connection

    The authentication setup that allows access to the Google Directory API. Ensures secure communication between the system and Google Directory.

  2. Organizational Unit Path

    The full path or unique ID of the Organizational Unit (OU) that needs to be updated. Example: corp/IT/Support or 12345.

  3. Fields to Update (At least one is required):

    3.1 Customer ID

    • The unique identifier for the customer’s Google account. Can use my_customer as an alias.
    • Found in Admin Console > Account Settings > Profile.

    3.2 Name of Organizational Unit

    • The new name for the Organizational Unit.
    • Example: Renaming Sales_Team to Global_Sales_Team.

    3.3Parent Organizational Unit

    • Specifies the new parent unit for the Organizational Unit.
    • Example: Moving Support from IT to Customer Service (corp/CustomerService/Support).

    3.4 Description

    • A text field for providing additional information about the Organizational Unit.
    • Example: "Handles internal IT support requests for the entire company."

Outputs Explanation

  1. Organization Unit ID

    • The unique identifier assigned to the Organizational Unit by Google Directory.
    • Example: 00bcd1234xyz

  2. Organization Unit Path

    • The full path of the updated Organizational Unit.
    • Example: /corp/CustomerService/Support

  3. Name of Organizational Unit

    • The updated name of the Organizational Unit.
    • Example: Global_Sales_Team

  4. Parent Organizational Unit

    • The new parent Organizational Unit that the updated unit is now under.
    • Example: /corp/CustomerService

  5. Parent Organizational Unit ID

    • The unique identifier of the parent Organizational Unit.
    • Example: 00345xyz789

  6. Description

    • The updated description of the Organizational Unit, providing context or details about its purpose.
    • Example: "Handles IT support for North America."

Example Scenario: Updating an Organizational Unit

Scenario Overview

A company, TechCorp, has undergone a restructuring process. The "Global Support" team, which was originally under "Customer Service", needs to be moved under "Technical Operations" to better align with internal processes. Additionally, the team’s name should be updated to "Technical Support", and a description needs to be added for clarity.

Steps to Set Up the Action

  1. Select the "Update Organizational Unit" Action

    • Navigate to the Google Directory category and choose the "Update Organizational Unit" action.

  2. Enter the Required Inputs

    • Connection → Select the authorized connection to Google Directory.
    • Organizational Unit Path → /CustomerService/GlobalSupport
    • Name of Organizational Unit → Technical Support
    • Parent Organizational Unit → /TechnicalOperations
    • Description → "Handles all technical support requests globally."

  3. Execute the flow

    • Once all fields are set, run the flow to update the Organizational Unit.

  4. Verify the Changes

    • After execution, check the outputs to confirm:
      • The Organizational Unit ID remains the same but is now associated with the new parent.
      • The Organizational Unit Path is updated to /TechnicalOperations/TechnicalSupport.
      • The Description is updated accordingly.

Expected Outcome

The "Global Support" team is successfully renamed to "Technical Support", moved under "Technical Operations", and now has a clear description for its role.

Updated about 9 hours ago