A partir de
8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa
página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Visão geral
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O acesso do usuário rege as operações que as pessoas podem realizar no produto Display & Video 360. Os usuários são identificados pela conta do
Google usada durante a autenticação. O acesso de um usuário é determinado pelas funções atribuídas, que são vinculadas aos recursos Partner ou Advertiser do Display & Video 360.
Este guia descreve como encontrar e criar usuários, além de atribuir a eles funções de usuário pela API do Display & Video 360.
Pré-requisitos
Antes de começar a trabalhar com os serviços de usuário da API Display & Video 360, você precisa
concluir as etapas a seguir. Entre em contato com um usuário Administrador da sua equipe para ativar as funções de usuário do Display & Video 360 necessárias, se necessário:
Crie e autorize um projeto de API conforme descrito no guia
Primeiros passos.
Siga o fluxo da conta de serviço para autorização. Somente contas de serviço podem acessar o serviço da API users do Display & Video 360. Um escopo do OAuth específico para o serviço
users também precisa ser usado no processo de autenticação.
Verifique se a conta de serviço é um usuário do Display & Video 360 e tem as funções do usuário necessárias para os recursos. Somente a função Administrador permite fazer alterações em um usuário e nas funções atribuídas a ele. Qualquer outra função padrão só dá
acesso de leitura aos recursos do usuário.
Entender as funções do usuário
As funções atribuídas determinam o nível de acesso dos usuários a diferentes recursos de veiculação de anúncios do Display & Video 360. Informações importantes sobre as funções do usuário:
Uma função de usuário pode ser concedida para dois tipos de recurso diferentes:
Advertiser e Partner.
Algumas funções de usuário só podem ser atribuídas a um tipo de recurso específico.
Uma função de usuário atribuída a um parceiro concede automaticamente esse nível de acesso
a todos os anunciantes desse parceiro.
As funções do usuário também controlam outros usuários a que você tem acesso e se você
pode criar usuários ou modificar as funções atribuídas a outras pessoas. Como usuário, você só pode
ver os usuários que compartilham o acesso ao mesmo recurso. Por exemplo, se você
tiver acesso padrão a um recurso do parceiro, todos os usuários que tiverem acesso a esse
parceiro ou a qualquer um dos anunciantes abaixo dele serão incluídos em uma
resposta do método users.list.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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."]]
