Method: groups.memberships.searchTransitiveMemberships

Search transitive memberships of a group.

A transitive membership is any direct or indirect membership of a group. Actor must have view permissions to all transitive memberships.

HTTP request

GET https://cloudidentity.googleapis.com/v1beta1/{parent=groups/*}/memberships:searchTransitiveMemberships

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Resource name of the group to search transitive memberships in.

Format: groups/{group_id}, where group_id is the unique ID assigned to the Group.

Query parameters

Parameters
pageSize

integer

The default page size is 200 (max 1000).

pageToken

string

The nextPageToken value returned from a previous list request, if any.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The response message for MembershipsService.SearchTransitiveMemberships.

JSON representation
{
  "memberships": [
    {
      object (MemberRelation)
    }
  ],
  "nextPageToken": string
}
Fields
memberships[]

object (MemberRelation)

List of transitive members satisfying the query.

nextPageToken

string

Token to retrieve the next page of results, or empty if there are no more results.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-identity.groups.readonly
  • https://www.googleapis.com/auth/cloud-identity.groups
  • https://www.googleapis.com/auth/cloud-identity
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

MemberRelation

Message representing a transitive membership of a group.

JSON representation
{
  "preferredMemberKey": [
    {
      object (EntityKey)
    }
  ],
  "member": string,
  "roles": [
    {
      object (TransitiveMembershipRole)
    }
  ],
  "relationType": enum (RelationType)
}
Fields
preferredMemberKey[]

object (EntityKey)

Entity key has an id and a namespace. In case of discussion forums, the id will be an email address without a namespace.

member

string

Resource name for this member if member is a GROUP, otherwise it is empty.

roles[]

object (TransitiveMembershipRole)

The membership role details (i.e name of role and expiry time).

relationType

enum (RelationType)

The relation between the group and the transitive member.