Method: users.bulkEditAssignedUserRoles

  • This method enables bulk editing of user roles by deleting and creating assigned roles in batches.

  • It requires the userId as a path parameter to identify the target user.

  • The request body specifies roles to delete (deletedAssignedUserRoles) and create (createdAssignedUserRoles).

  • Successful responses include a list of the successfully created assigned user roles (createdAssignedUserRoles).

  • It requires authorization with the https://www.googleapis.com/auth/display-video-user-management scope.

Bulk edits user roles for a user.

The operation will delete the assigned user roles provided in BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles and then assign the user roles provided in BulkEditAssignedUserRolesRequest.createdAssignedUserRoles.

This method has unique authentication requirements. Read the prerequisites in our Managing Users guide before using this method.

The "Try this method" feature does not work for this method.

HTTP request

POST https://displayvideo.googleapis.com/v3/users/{userId}:bulkEditAssignedUserRoles

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
userId

string (int64 format)

Required. The ID of the user to which the assigned user roles belong.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "deletedAssignedUserRoles": [
    string
  ],
  "createdAssignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
Fields
deletedAssignedUserRoles[]

string

The assigned user roles to delete in batch, specified as a list of assigned_user_role_ids. The format of assignedUserRoleId is entityType-entityid, for example partner-123.
createdAssignedUserRoles[]

object (AssignedUserRole)

The assigned user roles to create in batch, specified as a list of AssignedUserRoles.

Response body

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

JSON representation 
{
  "createdAssignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ]
}
Fields
createdAssignedUserRoles[]

object (AssignedUserRole)

The list of assigned user roles that have been successfully created.

This list will be absent if empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/display-video-user-management

For more information, see the OAuth 2.0 Overview.