Starting September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details on how to update your integration to make this declaration.
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.
[null,null,["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eThe Display & Video 360 API v1 \u003ccode\u003ebulkEditAssignedUserRoles\u003c/code\u003e method allows for batch updates of user roles, deleting and creating them in one operation.\u003c/p\u003e\n"],["\u003cp\u003eThis method requires specific authentication outlined in the Managing Users guide and does not support the "Try this method" feature.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes lists of assigned user roles to delete and create, identified by their respective IDs or object representations.\u003c/p\u003e\n"],["\u003cp\u003eA successful response provides a list of the newly created assigned user roles or an empty list if none were created.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video-user-management\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details the process of bulk editing user roles via the Display & Video 360 API. It utilizes a POST request to `https://displayvideo.googleapis.com/v1/users/{userId}:bulkEditAssignedUserRoles`, requiring a `userId` path parameter. The request body contains two fields: `deletedAssignedUserRoles` for roles to be removed and `createdAssignedUserRoles` for roles to be added. The response lists successfully created roles. This method needs specific authentication as detailed in the \"Managing Users\" guide and the user must use the `display-video-user-management` scope.\n"],null,["# Method: users.bulkEditAssignedUserRoles\n\n| Display \\& Video 360 API v1 has been sunset.\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BulkEditAssignedUserRolesResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nBulk edits user roles for a user.\n\nThe operation will delete the assigned user roles provided in [BulkEditAssignedUserRolesRequest.deletedAssignedUserRoles](/display-video/api/reference/rest/v1/users/bulkEditAssignedUserRoles#body.request_body.FIELDS.deleted_assigned_user_roles) and then assign the user roles provided in [BulkEditAssignedUserRolesRequest.createdAssignedUserRoles](/display-video/api/reference/rest/v1/users/bulkEditAssignedUserRoles#body.request_body.FIELDS.created_assigned_user_roles).\n\nThis method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method.\n\nThe \"Try this method\" feature does not work for this method.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v1/users/{userId}:bulkEditAssignedUserRoles`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the user to which the assigned user roles belong. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deletedAssignedUserRoles\": [ string ], \"createdAssignedUserRoles\": [ { object (/display-video/api/reference/rest/v1/users#AssignedUserRole) } ] } ``` |\n\n| Fields ||\n|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deletedAssignedUserRoles[]` | `string` The assigned user roles to delete in batch, specified as a list of [assigned_user_role_ids](/display-video/api/reference/rest/v1/users#AssignedUserRole.FIELDS.assigned_user_role_id). The format of assignedUserRoleId is `entityType-entityid`, for example `partner-123`. |\n| `createdAssignedUserRoles[]` | `object (`[AssignedUserRole](/display-video/api/reference/rest/v1/users#AssignedUserRole)`)` The assigned user roles to create in batch, specified as a list of [AssignedUserRoles](/display-video/api/reference/rest/v1/users#AssignedUserRole). |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"createdAssignedUserRoles\": [ { object (/display-video/api/reference/rest/v1/users#AssignedUserRole) } ] } ``` |\n\n| Fields ||\n|------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `createdAssignedUserRoles[]` | `object (`[AssignedUserRole](/display-video/api/reference/rest/v1/users#AssignedUserRole)`)` The list of assigned user roles that have been successfully created. This list will be absent if empty. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video-user-management`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]