Method: users.bulkEditAssignedUserRoles

  • The Display & Video 360 API v1 bulkEditAssignedUserRoles method allows for batch updates of user roles, deleting and creating them in one operation.

  • This method requires specific authentication outlined in the Managing Users guide and does not support the "Try this method" feature.

  • The request body includes lists of assigned user roles to delete and create, identified by their respective IDs or object representations.

  • A successful response provides a list of the newly created assigned user roles or an empty list if none were created.

  • Authorization requires the https://www.googleapis.com/auth/display-video-user-management OAuth 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/v1/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.