Method: sellers.adUnits.list

Lista os blocos de anúncios.

  • Por exemplo, GET /v1/sellers/seller111/adUnits
  • Retorna uma lista de blocos de anúncios e um token para recuperar a próxima página, caso seja bem-sucedido.
  • Retorna o código de erro PERMISSION_DENIED se o usuário não tiver acesso ao vendedor ou se o ID do vendedor não existir.
  • Retorna o código de erro INVALID_ARGUMENT se os vendedores fornecerem um tamanho de página ou token de página inválido.

Solicitação HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O vendedor, proprietário desse conjunto de blocos de anúncios. Formato: sellers/{seller}

Parâmetros de consulta

Parâmetros
pageSize

integer

O número máximo de itens para retornar. O serviço pode retornar menos que esse valor. O número máximo permitido de blocos de anúncios é 1.000. valores acima de 1.000 serão alterados para 1.000. Se não for especificado, serão retornados no máximo 1.000 blocos de anúncios.
pageToken

string

O valor nextPageToken retornado de uma solicitação de lista anterior, se houver.
filter

string

O filtro da lista. Atualmente oferece suporte a ID externo e filtragem de estado, com a sintaxe: "externalId = [EXTERNAL_ID]" e "estado = [ESTADO]". Os operadores lógicos AND e OR podem ser usados para encadear filtros. AD_UNIT_STATE_DELETED não pode ser usado para mostrar blocos de anúncios excluídos. Use showExcluído.
orderBy

string

A ordem por string usada para especificar a ordem de classificação dos resultados. Atualmente aceita a ordenação por updateTime, forneça "updateTime" para obter resultados classificados por updateTime em ordem crescente ou "updateTime desc" para ordem decrescente.
showDeleted

boolean

Indica se blocos de anúncios excluídos de forma reversível devem ser retornados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

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

Mensagem de resposta para InventoryService.Listblocos.

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

object (AdUnit)

A lista de blocos de anúncios.
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 adUnits.list para recuperar a próxima página de resultados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

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