REST Resource: users

Recurso: User

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 usado para identificar o usuário.
displayName

string

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

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

object (AssignedUserRole)

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

Obrigatório em users.create. Somente saída em users.patch. Só pode ser atualizado por meio de users.bulkEditAssignedUserRoles.
lastLoginTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora do último login do usuário na interface do DV360.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
Campos
assignedUserRoleId

string

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

enum (UserRole)

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

Obrigatório.

O ID da entidade a que a função de usuário atribuída se aplica. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
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.
Fim dos campos mutuamente exclusivos.

UserRole

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

Tipos enumerados
USER_ROLE_UNSPECIFIED Valor padrão quando o papel do usuário não é especificado ou é desconhecido 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 ver e editar informações de faturamento, criar ou modificar usuários e ativar ou desativar trocas. Essa função só pode ser atribuída a uma entidade de parceiro.
ADMIN_PARTNER_CLIENT O usuário pode gerenciar campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles podem criar e modificar outros usuários do ADMIN_PARTNER_CLIENT e ver informações de faturamento. Eles não podem ver modelos de receita, margens de lucro ou outros campos confidenciais do revendedor. Essa função só pode ser atribuída a uma entidade de parceiro.
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 ver 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 ver todas as campanhas, criativos, pedidos de inserção, itens de linha e relatórios da entidade. Eles também podem criar e 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 ou 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 ver informações de faturamento. Eles não podem ver modelos de receita, margens de lucro ou outros campos confidenciais do revendedor. Essa função só pode ser atribuída 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 pode criar e gerenciar somente os seguintes relatórios seguros para o cliente: Geral, Desempenho do público-alvo, Parceiros cruzados, Palavra-chave, Código do pedido, Categoria e Fornecedor 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 nem 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 nem dados relacionados ao custo. Além disso, eles podem adicionar outros admins de criativo ou usuários de criativo à entidade.

Métodos

bulkEditAssignedUserRoles

 Edita em massa as funções de um usuário.

create

 Cria um novo usuário.

delete

 Exclui um usuário.

get

 Recebe um usuário.

list

 Lista os usuários acessíveis ao usuário atual.

patch

 Atualiza um usuário.