REST Resource: users

Recurso: User

Inclua um único usuário no Display & Video 360.

Representação JSON 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Campos
name

string

Apenas saída. O nome do recurso do usuário.
userId

string (int64 format)

Apenas saída. O ID exclusivo do usuário. Atribuído pelo sistema.
email

string

Obrigatório. Imutável. O endereço de e-mail utilizado para identificar o usuário.
displayName

string

Obrigatório. O nome de exibição do usuário.

Ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
assignedUserRoles[]

object (AssignedUserRole)

As funções do usuário atribuídas.

Obrigatório em users.create. Saída apenas em users.patch. Só pode ser atualizado pelo users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o usuário fez login pela última vez na interface do DV360.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

Uma única função do usuário atribuída, que define a interação autorizada de um usuário com um parceiro ou anunciante especificado.

Representação JSON 
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
Campos
assignedUserRoleId

string

Apenas saída. ID da função do usuário atribuída.
userRole

enum (UserRole)

Obrigatório. A função do usuário a ser atribuída a um usuário na entidade.

Campo de união entity_id. Obrigatório.

O ID da entidade à qual a função de usuário atribuída se aplica. entity_id pode ser apenas de um dos tipos a seguir:
partnerId

string (int64 format)

O ID do parceiro ao qual a função de usuário atribuída se aplica.
advertiserId

string (int64 format)

O ID do anunciante ao qual a função de usuário atribuída se aplica.

UserRole

Possíveis funções do usuário.

Enums
USER_ROLE_UNSPECIFIED Valor padrão quando a função do usuário não é especificada ou é desconhecida nesta versão.
ADMIN O usuário pode gerenciar campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles podem visualizar e editar informações de faturamento, criar ou modificar usuários e ativar ou desativar as trocas. Esse papel só pode ser atribuído a uma entidade parceira.
ADMIN_PARTNER_CLIENT O usuário pode gerenciar campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Ele pode criar e modificar outros usuários do ADMIN_PARTNER_CLIENT e ver as informações de faturamento. Eles não podem visualizar modelos de receita, marcações nem qualquer outro campo sensível ao revendedor. Esse papel só pode ser atribuído a uma entidade parceira.
STANDARD O usuário pode gerenciar campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles não podem criar e modificar usuários nem visualizar informações de faturamento.
STANDARD_PLANNER O usuário pode ver todas as campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade, incluindo todos os dados de custo. Eles podem criar e modificar recursos relacionados ao planejamento, incluindo planos e inventário.
STANDARD_PLANNER_LIMITED O usuário pode visualizar todas as campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles podem criar ou modificar recursos relacionados ao planejamento, incluindo planos e inventário. Eles não têm acesso aos dados de custo e não podem iniciar, aceitar nem negociar transações.
STANDARD_PARTNER_CLIENT O usuário pode gerenciar campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles não podem criar ou modificar outros usuários nem visualizar informações de faturamento. Eles não podem visualizar modelos de receita, marcações nem qualquer outro campo sensível ao revendedor. Esse papel só pode ser atribuído a uma entidade de anunciante.
READ_ONLY O usuário só pode criar relatórios e visualizar dados da entidade.
REPORTING_ONLY O usuário só pode criar e gerenciar relatórios.
LIMITED_REPORTING_ONLY O usuário só pode criar e gerenciar os seguintes relatórios seguros para o cliente: geral, desempenho do público-alvo, parceiros cruzados, palavra-chave, código do pedido, categoria e provedor de dados de terceiros.
CREATIVE O usuário pode visualizar as informações do plano de mídia de que precisa para colaborar, mas não pode ver o Marketplace ou dados relacionados ao custo.
CREATIVE_ADMIN O usuário pode visualizar as informações do plano de mídia de que precisa para colaborar, mas não pode ver o Marketplace ou dados relacionados ao custo. Além disso, eles podem adicionar outros administradores ou usuários à entidade.

Métodos

bulkEditAssignedUserRoles

 Faz a edição em massa das funções de um usuário.

create

 Cria um novo usuário.

delete

 Exclui um usuário.

get

 Extrai um usuário.

list

 Lista os usuários que podem ser acessados pelo usuário atual.

patch

 Atualiza um usuário existente.