Method: users.list

Lista os usuários 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 Como gerenciar usuários antes de usar esse método.

O recurso "Testar este método" não funciona para este método.

Solicitação HTTP

GET https://displayvideo.googleapis.com/v1/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 pela 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 aceitos são:

  • displayName (padrão)

A ordem de classificação padrão é crescente. Para especificar a ordem decrescente em um campo, adicione um sufixo "desc" ao nome dele. 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}.
  • O campo budget.budget_segments.date_range.end_date precisa usar o operador LESS THAN (<).
  • O operador displayName andemailfield must use theHAS (:)`.
  • Todos os outros campos precisam usar o operador EQUALS (=).

Campos compatíveis:

  • assignedUserRole.advertiserId
  • assignedUserRole.entityType
  • Este é o campo sintético de AssignedUserRole usado para filtragem. Identifica o tipo de entidade à qual a função do usuário é atribuída. Os valores válidos são Partner e Advertiser.
  • assignedUserRole.parentPartnerId
  • Este é um campo sintético de AssignedUserRole usado para filtragem. Identifica o parceiro pai da entidade a que a função de usuário é atribuída.
  • assignedUserRole.partnerId
  • assignedUserRole.userRole
  • displayName
  • email

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 de usuário padrão: assignedUserRole.userRole="STANDARD"
  • Todos os usuários com funções do usuário para o 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 de usuário no nível do parceiro: entityType="PARTNER"
  • Todos os usuários com funções do usuário para o parceiro 123 e os anunciantes abaixo do parceiro 123: parentPartnerId="123"

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

Consulte nosso guia de filtragem de solicitações 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)

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.