DV360 Out of Home Seller API

Com a API Out of Home Seller do DV360, é possível gerenciar inventário, reservar pedidos, gerar criativos e enviar eventos de reprodução de anúncio.

Serviço: dv360outofhomeseller.googleapis.com

Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso seu aplicativo precise usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir quando fizer as solicitações de API.

Documento de descoberta

Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. Este serviço apresenta os documentos de descoberta abaixo:

Endpoint de serviço

Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir e todos os URIs abaixo são relativos a ele:

  • https://dv360outofhomeseller.googleapis.com

Recurso REST: v1beta1

Métodos
lookupByExternalId POST /v1beta1:lookupByExternalId
Recupera todas as entidades por ID externo listado na solicitação.

Recurso REST: v1beta1.adPlays

Métodos
create POST /v1beta1/adPlays
Cria uma reprodução do anúncio.
createWithExternalIds POST /v1beta1/adPlays:createWithExternalIds
Cria uma reprodução de anúncios com IDs externos.

Recurso REST: v1beta1.adUnits

Métodos
create POST /v1beta1/adUnits
Cria um novo bloco de anúncios.
delete DELETE /v1beta1/{name=adUnits/*}
Exclui um bloco de anúncios existente.
get GET /v1beta1/{name=adUnits/*}
Recupera um bloco de anúncios individual.
list GET /v1beta1/adUnits
Lista os blocos de anúncios.
patch PATCH /v1beta1/{adUnit.name=adUnits/*}
Atualiza um bloco de anúncios existente.

Recurso REST: v1beta1.availabilityOrders

Métodos
complete POST /v1beta1/{name=availabilityOrders/*}:complete
Marca um pedido de disponibilidade existente como concluído.
get GET /v1beta1/{name=availabilityOrders/*}
Recupera um pedido de disponibilidade individual.
list GET /v1beta1/availabilityOrders
Lista os pedidos de disponibilidade.

Recurso REST: v1beta1.availabilityOrders.availabilityLines

Métodos
complete POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:complete
Marca uma linha de disponibilidade existente como concluída.
get GET /v1beta1/{name=availabilityOrders/*/availabilityLines/*}
Recupera uma linha individual para um pedido de disponibilidade.
list GET /v1beta1/{parent=availabilityOrders/*}/availabilityLines
Lista as linhas para um pedido de disponibilidade.
reject POST /v1beta1/{name=availabilityOrders/*/availabilityLines/*}:reject
Marca uma linha de disponibilidade existente como rejeitada.

Recurso REST: v1beta1.creativeAssets

Métodos
get GET /v1beta1/{name=creativeAssets/*}
Recupera um recurso do criativo individual.
list GET /v1beta1/creativeAssets
Lista os recursos do criativo.
patch PATCH /v1beta1/{creativeAsset.name=creativeAssets/*}
Atualiza um recurso do criativo existente.

Recurso REST: v1beta1.orders

Métodos
get GET /v1beta1/{name=orders/*}
Recupera um pedido individual.
list GET /v1beta1/orders
Lista os pedidos.
patch PATCH /v1beta1/{order.name=orders/*}
Atualiza um pedido existente.

Recurso REST: v1beta1.orders.lines

Métodos
book POST /v1beta1/{name=orders/*/lines/*}:book
Reservar uma linha existente.
get GET /v1beta1/{name=orders/*/lines/*}
Recupera uma linha individual de um pedido.
list GET /v1beta1/{parent=orders/*}/lines
Lista as linhas de um pedido.
patch PATCH /v1beta1/{line.name=orders/*/lines/*}
Atualiza uma linha existente.
reject POST /v1beta1/{name=orders/*/lines/*}:reject
Rejeita uma linha existente.
reserve POST /v1beta1/{name=orders/*/lines/*}:reserve
Reserva uma linha existente.

Recurso REST: v1beta1.orders.lines.assignments

Métodos
approve POST /v1beta1/{name=orders/*/lines/*/assignments/*}:approve
Aprova uma atividade.
disapprove POST /v1beta1/{name=orders/*/lines/*/assignments/*}:disapprove
Reprova uma atribuição existente.
get GET /v1beta1/{name=orders/*/lines/*/assignments/*}
Recupera uma atribuição individual para uma linha.
list GET /v1beta1/{parent=orders/*/lines/*}/assignments
Lista as atribuições de uma linha.
patch PATCH /v1beta1/{assignment.name=orders/*/lines/*/assignments/*}
Atualiza uma atividade existente.

Recurso REST: v1beta1.products

Métodos
create POST /v1beta1/products
Cria um novo produto.
get GET /v1beta1/{name=products/*}
Recupera um produto individual.
list GET /v1beta1/products
Lista os produtos.
patch PATCH /v1beta1/{product.name=products/*}
Atualiza um produto existente.

Recurso REST: v1.sellers.adPlays

Métodos
batchCreate POST /v1/{parent=sellers/*}/adPlays:batchCreate
Cria novas reproduções de anúncio em lote.
create POST /v1/{parent=sellers/*}/adPlays
Cria uma reprodução do anúncio.

Recurso REST: v1.sellers.adUnits

Métodos
create POST /v1/{parent=sellers/*}/adUnits
Cria um novo bloco de anúncios.
delete DELETE /v1/{name=sellers/*/adUnits/*}
Exclui um bloco de anúncios existente.
get GET /v1/{name=sellers/*/adUnits/*}
Recupera um bloco de anúncios individual.
list GET /v1/{parent=sellers/*}/adUnits
Lista os blocos de anúncios.
patch PATCH /v1/{adUnit.name=sellers/*/adUnits/*}
Atualiza um bloco de anúncios existente.

Recurso REST: v1.sellers.adUnits.impressionSchedules

Métodos
batchUpdate POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules:batchUpdate
Atualiza programações de impressões em lote.
create POST /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Cria uma nova programação de impressões.
get GET /v1/{name=sellers/*/adUnits/*/impressionSchedules/*}
Recupera uma programação de impressões individual.
list GET /v1/{parent=sellers/*/adUnits/*}/impressionSchedules
Lista as programações de impressões.
patch PATCH /v1/{impressionSchedule.name=sellers/*/adUnits/*/impressionSchedules/*}
Atualiza uma programação de impressões existente.

Recurso REST: v1.sellers.availabilityOrders

Métodos
complete POST /v1/{name=sellers/*/availabilityOrders/*}:complete
Marca um pedido de disponibilidade existente como concluído.
get GET /v1/{name=sellers/*/availabilityOrders/*}
Recupera um pedido de disponibilidade individual.
list GET /v1/{parent=sellers/*}/availabilityOrders
Lista os pedidos de disponibilidade.

Recurso REST: v1.sellers.availabilityOrders.availabilityLines

Métodos
complete POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:complete
Marca uma linha de disponibilidade existente como concluída.
get GET /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}
Recupera uma linha individual para um pedido de disponibilidade.
list GET /v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines
Lista as linhas para um pedido de disponibilidade.
reject POST /v1/{name=sellers/*/availabilityOrders/*/availabilityLines/*}:reject
Marca uma linha de disponibilidade existente como rejeitada.

Recurso REST: v1.sellers.creativeAssets

Métodos
get GET /v1/{name=sellers/*/creativeAssets/*}
Recupera um recurso do criativo individual.
list GET /v1/{parent=sellers/*}/creativeAssets
Lista os recursos do criativo.
patch PATCH /v1/{creativeAsset.name=sellers/*/creativeAssets/*}
Atualiza um recurso do criativo existente.

Recurso REST: v1.sellers.orders

Métodos
completeOrderBooking POST /v1/{order=sellers/*/orders/*}:completeOrderBooking
Conclua a reserva do pedido.
completeOrderReservation POST /v1/{order=sellers/*/orders/*}:completeOrderReservation
Conclua a reserva do pedido.
create POST /v1/{parent=sellers/*}/orders
Cria um novo pedido.
get GET /v1/{name=sellers/*/orders/*}
Recupera um pedido individual.
list GET /v1/{parent=sellers/*}/orders
Lista os pedidos.
patch PATCH /v1/{order.name=sellers/*/orders/*}
Atualiza um pedido existente.

Recurso REST: v1.sellers.orders.lines

Métodos
book POST /v1/{name=sellers/*/orders/*/lines/*}:book
Reservar uma linha existente.
create POST /v1/{parent=sellers/*/orders/*}/lines
Cria uma nova linha.
get GET /v1/{name=sellers/*/orders/*/lines/*}
Recupera uma linha individual de um pedido.
list GET /v1/{parent=sellers/*/orders/*}/lines
Lista as linhas de um pedido.
patch PATCH /v1/{line.name=sellers/*/orders/*/lines/*}
Atualiza uma linha existente.
reject POST /v1/{name=sellers/*/orders/*/lines/*}:reject
Rejeita uma linha existente.
reserve POST /v1/{name=sellers/*/orders/*/lines/*}:reserve
Reserva uma linha existente.

Recurso REST: v1.sellers.orders.lines.assignments

Métodos
approve POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:approve
Aprova uma atividade.
disapprove POST /v1/{name=sellers/*/orders/*/lines/*/assignments/*}:disapprove
Reprova uma atribuição existente.
get GET /v1/{name=sellers/*/orders/*/lines/*/assignments/*}
Recupera uma atribuição individual para uma linha.
list GET /v1/{parent=sellers/*/orders/*/lines/*}/assignments
Lista as atribuições de uma linha.
patch PATCH /v1/{assignment.name=sellers/*/orders/*/lines/*/assignments/*}
Atualiza uma atividade existente.

Recurso REST: v1.sellers.products

Métodos
create POST /v1/{parent=sellers/*}/products
Cria um novo produto.
delete DELETE /v1/{name=sellers/*/products/*}
Exclui um produto existente.
get GET /v1/{name=sellers/*/products/*}
Recupera um produto individual.
list GET /v1/{parent=sellers/*}/products
Lista os produtos.
patch PATCH /v1/{product.name=sellers/*/products/*}
Atualiza um produto existente.