Method: inventorySourceGroups.list

Lista os grupos de origem de inventário acessíveis ao usuário atual.

A ordem é definida pelo parâmetro orderBy.

Solicitação HTTP

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

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, 100 será usado como padrão.

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 ListInventorySources. Se não for especificado, a primeira página de resultados será retornada.

orderBy

string

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

  • displayName (padrão)
  • inventorySourceGroupId

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

filter

string

Permite filtrar por campos de grupos de origem de inventário.

Sintaxe aceita:

  • As expressões de filtro são compostas por uma ou mais restrições.
  • As restrições podem ser combinadas pelo operador lógico OR.
  • Uma restrição tem o formato {field} {operator} {value}.
  • Todos os campos precisam usar o operador EQUALS (=).

Campos compatíveis:

  • inventorySourceGroupId

O comprimento desse campo não pode exceder 500 caracteres.

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

Parâmetro de união accessor. Obrigatório. Identifica a entidade do DV360 em que a solicitação está sendo feita. A solicitação LIST só vai retornar as entidades do grupo de origem de inventário que são acessíveis à entidade do DV360 identificada no accessor. accessor pode ser apenas de um dos tipos a seguir:
partnerId

string (int64 format)

O ID do parceiro que tem acesso ao grupo de origem de inventário.

Um parceiro não pode acessar grupos de origem de inventário pertencentes ao anunciante.

advertiserId

string (int64 format)

O ID do anunciante que tem acesso ao grupo de origens de inventário.

Se um grupo de origem de inventário for de propriedade do parceiro, somente os anunciantes com quem o grupo for compartilhado explicitamente poderão acessá-lo.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para InventorySourceGroupService.ListInventorySourceGroups.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

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

object (InventorySourceGroup)

A lista de grupos de origem de inventário.

Essa lista não será exibida se estiver vazia.

nextPageToken

string

Um token para recuperar a próxima página de resultados. Transmita esse valor no campo pageToken na chamada subsequente para o método inventorySourceGroups.list para recuperar a próxima página de resultados.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.