A partir del
8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra
página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Descripción general
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El acceso de los usuarios rige las operaciones que las personas pueden realizar en el producto Display & Video 360. Los usuarios se identifican con la Cuenta de Google que se usa durante la autenticación. El alcance del acceso de un usuario se determina según los roles asignados, que están vinculados a los recursos Partner o Advertiser de Display & Video 360.
En esta guía, se describe cómo encontrar y crear usuarios, así como asignarles roles a través de la API de Display & Video 360.
Requisitos previos
Antes de comenzar a trabajar con los servicios de usuario de la API de Display & Video 360, deberás completar los siguientes pasos. Si es necesario, comunícate con un usuario Administrador existente de tu equipo para que habilite los roles de usuario necesarios de Display & Video 360:
Crea y autoriza un proyecto de API como se describe en nuestra guía de Comenzar.
Asegúrate de seguir el flujo de cuenta de servicio para la autorización. Solo las cuentas de servicio pueden acceder al servicio users de la API de Display & Video 360. También se debe usar un alcance de OAuth específico para el servicio users en el proceso de autenticación.
Asegúrate de que la cuenta de servicio sea un usuario de Display & Video 360 y tenga los roles de usuario necesarios para los recursos necesarios. Solo el rol de Administrador te permite realizar cambios en un usuario y en sus roles asignados. Cualquier otro rol estándar solo te otorga acceso de lectura a los recursos del usuario.
Comprende los roles de los usuarios
Los roles asignados a los usuarios determinan el nivel de acceso que tienen a los diferentes recursos de publicación de anuncios de Display & Video 360. A continuación, se incluyen algunos aspectos importantes que debes saber sobre los roles de usuario:
Se puede asignar un rol de usuario para dos tipos de recursos diferentes: Advertiser y Partner.
Algunos roles de usuario solo se pueden asignar para un tipo de recurso específico.
Un rol de usuario asignado a un socio otorga automáticamente ese nivel de acceso a todos los anunciantes de ese socio.
Los roles de usuario también controlan a qué otros usuarios tienes acceso y si puedes crear usuarios o modificar los roles asignados de otros. Como usuario, solo puedes ver a los usuarios que comparten el acceso al mismo recurso. Por ejemplo, si tienes acceso estándar a un recurso de socio, todos los usuarios que tengan acceso a ese socio o a cualquiera de los anunciantes que se encuentran debajo de él se incluirán en una respuesta del método users.list.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eDisplay & Video 360 user access is determined by assigned user roles linked to Partner or Advertiser resources.\u003c/p\u003e\n"],["\u003cp\u003eThis guide explains how to find, create, and assign user roles to users through the Display & Video 360 API using service accounts.\u003c/p\u003e\n"],["\u003cp\u003eOnly Admin user roles can modify users and their roles; other roles only provide read access to user resources.\u003c/p\u003e\n"],["\u003cp\u003eUser access is limited to resources they share with other users, meaning visibility is restricted to users with overlapping resource access.\u003c/p\u003e\n"],["\u003cp\u003eUser roles can be assigned at the Partner or Advertiser level, with some roles specific to a resource type and Partner-level roles granting access to all advertisers under that Partner.\u003c/p\u003e\n"]]],["Users in Display & Video 360 are identified by their Google account, and their actions are dictated by assigned roles linked to Partner or Advertiser resources. To use the API, an API project needs authorization, and only service accounts can access the user service with a specific OAuth scope. Admin users can create and modify users and roles; others can only read. User roles grant access to resources; roles at the partner level automatically apply to all advertisers. Users can only see those with access to the same resources.\n"],null,["# Overview\n\nUser access governs the operations individuals can do within the\nDisplay \\& Video 360 product. [Users](/display-video/api/reference/rest/current/users) are identified by the Google\naccount used during authentication. The extent of a user's access is determined\nby their assigned user roles, which are linked to Display \\& Video 360\n[`Partner`](/display-video/api/reference/rest/current/partners) or [`Advertiser`](/display-video/api/reference/rest/current/advertisers) resources.\n\nThis guide describes how to find and create users, as well as assign them user\nroles through the Display \\& Video 360 API.\n\nPrerequisites\n-------------\n\nBefore you start working with Display \\& Video 360 API User services, you'll need to\ncomplete the following steps. Contact an existing **Admin** user on your team to\nhave the necessary Display \\& Video 360 user roles enabled, if necessary:\n\n1. Create and authorize an API project as outlined in our\n [Get Started](/display-video/api/guides/getting-started) guide.\n\n2. Ensure that you're following the [service account](/display-video/api/guides/how-tos/service-account)\n flow for authorization. Only service accounts can access the Display \\& Video 360 API\n [`users`](/display-video/api/reference/rest/current/users) service. An [OAuth scope specific to the `users`\n service](/display-video/api/reference/rest/current/users/get#authorization-scopes) must also be used in the authentication process.\n\n3. Ensure that the service account is a Display \\& Video 360 user, and has the\n requisite [user roles](//support.google.com/displayvideo/answer/2723011) for the necessary resources. Only the\n [Admin](/display-video/api/reference/rest/current/users#UserRole.ENUM_VALUES.ADMIN) role allows you to make changes to a user and their\n assigned user roles. Any other [standard role](//support.google.com/displayvideo/answer/2723011#user-roles) only gives\n you read access to user resources.\n\nUnderstand user roles\n---------------------\n\nAssigned user roles determine the level of access users have to different\nDisplay \\& Video 360 ad-serving resources. Important things to know about user\nroles include:\n\n- A user role can be given for two different resource types:\n [`Advertiser`](/display-video/api/reference/rest/current/advertisers) and [`Partner`](/display-video/api/reference/rest/current/partners).\n\n- Some user roles can only be assigned for a specific resource type.\n\n- A user role assigned for a partner automatically grants that level of access\n to all advertisers under that partner.\n\nUser roles also control which other users you have access to, and whether you\ncan create users and or modify others' assigned roles. **As a user, you can\nonly see users who share access to the same resource.** For example, if you\nhave standard access to a partner resource, all users who have access to that\npartner or any of the advertisers under it will be included in a\n[`users.list`](/display-video/api/reference/rest/current/users/list) method response."]]
