Search Role Assignments

Search for role assignments in a Google Workspace.

Options

Field Definition Type Required

Result Set

Choose a method to filter search results:

  • First Matching Record: Returns the first record that matches.

  • First 100 Matching Records: Returns the first 100 matching records.

  • Stream Matching Records: Passes all matching records from your parent flow to a helper flow.

    Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.

Dropdown

TRUE

Input

Field Definition Type Required

Customer

Customer ID

The unique ID of the Google Workspace account.

You can also use the my_customer alias to represent your account's Customer ID.

Text

TRUE

Filters

Role ID

Unique ID of a role.

If included in the request, the card returns only role assignments containing this role ID.

Text

FALSE

Resource Key

The primary email address, alias email address, unique user ID, or group ID.

If included in the request, the card only returns role assignments for this user or group.

Text

FALSE

Indirect Role Assignments

When set to true, the card returns direct and indirect role assignments (that is, a role assignment through a group).

If you don't specify a Resource Key, the card doesn't include the indirect role assignments.

The default is false.

True/False

FALSE

Streaming

Flow

Click Choose Flow to browse and select a helper flow where the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

Flow

TRUE

Search Criteria

Record Limit

Specify the number of records to stream.

  • When the Limit field is set to 0, the stream returns no records.

  • When the Limit field is set to greater than 0, the stream returns up to the maximum number specified.

  • When the Limit field is empty, null, or not selected, the stream returns all records.

  • The default value is 500000 (500 thousand).

  • The valid range is from 1 through 500000.

This field appears when you select Stream Matching Records from the Result Set option.

Number

FALSE

Output

Field Definition Type

Result

Role Assignment ID

Unique ID of the role assignment.

Text

Role ID

The unique ID of the role that's associated with the assignment.

Text

Assigned To

The unique ID of the entity this role is assigned to.

Text

Assignee Type

The type of the assignee: either user or group.

Text

Scope Type

The scope that contains this role.

Text

Org Unit ID

If the role is restricted to an organization unit, then this field contains the ID for that organization.

Text

Kind

The type of the API resource.

Text

ETag

The ETag of the resource.

Text

Records Streamed

Number of records streamed in a streaming flow.

This field appears when you select Stream Matching Records from the Result Set option.

Number