Method: users.list

Lista os usuários que estão acessíveis ao usuário atual. Se dois usuários tiverem funções de usuário no mesmo parceiro ou anunciante, eles poderão acessar um ao outro.

Esse método tem requisitos de autenticação exclusivos. Leia os pré-requisitos no guia de gerenciamento de usuários antes de usar este método.

O botão "Testar este método" não funciona com esse método.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v3/users

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
pageSize

integer

Tamanho da página solicitada. O valor precisa estar entre 1 e 200. Se não for especificado, o padrão será 100.
pageToken

string

Um token que identifica a página de resultados que o servidor retornará. Normalmente, esse é o valor de nextPageToken retornado da chamada anterior para o método users.list. Se não for especificado, a primeira página de resultados será retornada.
orderBy

string

Campo que classificará a lista. Os valores aceitáveis são:

  • displayName (padrão)

A ordem de classificação padrão é crescente. Para especificar a ordem decrescente de um campo, use o sufixo "desc" deve ser adicionado ao nome do campo. Por exemplo, displayName desc.
filter

string

Permite filtrar por campos de usuário.

Sintaxe compatível:

  • As expressões de filtro são compostas por uma ou mais restrições.
  • As restrições podem ser combinadas pelo operador lógico AND.
  • Uma restrição tem o formato {field} {operator} {value}.
  • Os campos displayName e email precisam usar o operador HAS (:).
  • O campo lastLoginTime precisa usar o operador LESS THAN OR EQUAL TO (<=) ou GREATER THAN OR EQUAL TO (>=).
  • Todos os outros campos precisam usar o operador EQUALS (=).

Campos compatíveis:

  • assignedUserRole.advertiserId
  • assignedUserRole.entityType: é um campo sintético de AssignedUserRole usado para filtragem. Identifica o tipo de entidade ao qual a função de usuário é atribuída. Os valores válidos são Partner e Advertiser.
  • assignedUserRole.parentPartnerId: é um campo sintético de AssignedUserRole usado para filtragem. Identifica o parceiro pai da entidade à qual o papel do usuário é atribuído.
  • assignedUserRole.partnerId
  • assignedUserRole.userRole
  • displayName
  • email
  • lastLoginTime (entrada no formato ISO 8601 ou YYYY-MM-DDTHH:MM:SSZ)

Exemplos:

  • O usuário com displayName contendo "foo": displayName:"foo"
  • O usuário com email contendo "bar": email:"bar"
  • Todos os usuários com funções do usuário padrão: assignedUserRole.userRole="STANDARD"
  • Todos os usuários com funções do parceiro 123: assignedUserRole.partnerId="123"
  • Todos os usuários com funções do usuário para o anunciante 123: assignedUserRole.advertiserId="123"
  • Todos os usuários com funções no nível do parceiro: entityType="PARTNER"
  • Todos os usuários com funções do usuário para o parceiro 123 e anunciantes do parceiro 123: parentPartnerId="123"
  • Todos os usuários que fizeram login pela última vez em 2023-01-01T00:00:00Z (formato ISO 8601): lastLoginTime>="2023-01-01T00:00:00Z"

Esse campo não pode ter mais de 500 caracteres.

Consulte nosso guia de solicitações de filtro de LIST para mais informações.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON 
{
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
Campos
users[]

object (User)

A lista de usuários.

Esta lista estará ausente se estiver vazia.
nextPageToken

string

Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada seguinte para o método users.list para recuperar a próxima página de resultados. Esse token estará ausente se não houver mais resultados a serem retornados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/display-video-user-management

Para mais informações, consulte a Visão geral do OAuth 2.0.