Display & Video 360 API

Com a API Display & Video 360, os usuários podem automatizar fluxos de trabalho complexos do Display & Video 360, como a criação de pedidos de inserção e a definição de opções de segmentação para itens de linha individuais.

Serviço: displayvideo.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. O serviço fornece o seguinte documento de detecção:

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://displayvideo.googleapis.com

Recurso REST: v1.advertisers

Métodos
audit GET /v1/advertisers/{advertiserId}:audit
Audita um anunciante.
bulkEditAdvertiserAssignedTargetingOptions POST /v1/advertisers/{advertiserId}:bulkEditAdvertiserAssignedTargetingOptions
Edição em massa de opções de segmentação em um único anunciante.
bulkListAdvertiserAssignedTargetingOptions GET /v1/advertisers/{advertiserId}:bulkListAdvertiserAssignedTargetingOptions
Lista as opções de segmentação atribuídas de um anunciante em diferentes tipos de segmentação.
create POST /v1/advertisers
Cria um novo anunciante.
delete DELETE /v1/advertisers/{advertiserId}
Exclui um anunciante.
get GET /v1/advertisers/{advertiserId}
Extrai um anunciante.
list GET /v1/advertisers
Lista os anunciantes acessíveis ao usuário atual.
patch PATCH /v1/advertisers/{advertiser.advertiserId}
Atualiza um anunciante existente.

Recurso REST: v1.advertisers.assets

Métodos
upload POST /v1/advertisers/{advertiserId}/assets
POST /upload/v1/advertisers/{advertiserId}/assets
Faz o upload de um recurso.

Recurso REST: v1.advertisers.campaigns

Métodos
bulkListCampaignAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}:bulkListCampaignAssignedTargetingOptions
Lista as opções de segmentação atribuídas a uma campanha nos diferentes tipos de segmentação.
create POST /v1/advertisers/{campaign.advertiserId}/campaigns
Cria uma nova campanha.
delete DELETE /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Exclui uma campanha permanentemente.
get GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}
Recebe uma campanha.
list GET /v1/advertisers/{advertiserId}/campaigns
Lista as campanhas de um anunciante.
patch PATCH /v1/advertisers/{campaign.advertiserId}/campaigns/{campaign.campaignId}
Atualiza uma campanha existente.

Recurso REST: v1.advertisers.campaigns.targetingTypes.assignedTargetingOptions

Métodos
get GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Recebe uma única opção de segmentação atribuída a uma campanha.
list GET /v1/advertisers/{advertiserId}/campaigns/{campaignId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lista as opções de segmentação atribuídas a uma campanha para um tipo de segmentação especificado.

Recurso REST: v1.advertisers.channels

Métodos
create POST /v1/advertisers/{advertiserId}/channels
Cria um novo canal.
get GET /v1/advertisers/{advertiserId}/channels/{channelId}
Extrai um canal para um parceiro ou anunciante.
list GET /v1/advertisers/{advertiserId}/channels
Lista os canais de um parceiro ou anunciante.
patch PATCH /v1/advertisers/{advertiserId}/channels/{channel.channelId}
Atualiza um canal.

Recurso REST: v1.advertisers.channels.sites

Métodos
bulkEdit POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
Edita sites em massa em um único canal.
create POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Cria um site em um canal.
delete DELETE /v1/advertisers/{advertiserId}/channels/{channelId}/sites/{urlOrAppId}
Exclui um site de um canal.
list GET /v1/advertisers/{advertiserId}/channels/{channelId}/sites
Lista os sites em um canal.
replace POST /v1/advertisers/{advertiserId}/channels/{channelId}/sites:replace
Substitui todos os sites em um único canal.

Recurso REST: v1.advertisers.creatives

Métodos
create POST /v1/advertisers/{creative.advertiserId}/creatives
Gera um novo criativo.
delete DELETE /v1/advertisers/{advertiserId}/creatives/{creativeId}
Exclui um criativo.
get GET /v1/advertisers/{advertiserId}/creatives/{creativeId}
Recebe um criativo.
list GET /v1/advertisers/{advertiserId}/creatives
Lista os criativos em um anunciante.
patch PATCH /v1/advertisers/{creative.advertiserId}/creatives/{creative.creativeId}
Atualiza um criativo existente.

Recurso REST: v1.advertisers.insertionOrders

Métodos
bulkListInsertionOrderAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}:bulkListInsertionOrderAssignedTargetingOptions
Lista as opções de segmentação atribuídas de um pedido de inserção em diferentes tipos de segmentação.
create POST /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders
Cria um novo pedido de inserção.
delete DELETE /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Exclui um pedido de inserção.
get GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}
Recebe um pedido de inserção.
list GET /v1/advertisers/{advertiserId}/insertionOrders
Lista os pedidos de inserção de um anunciante.
patch PATCH /v1/advertisers/{insertionOrder.advertiserId}/insertionOrders/{insertionOrder.insertionOrderId}
Atualiza um pedido de inserção existente.

Recurso REST: v1.advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Métodos
get GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Recebe uma única opção de segmentação atribuída a um pedido de inserção.
list GET /v1/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lista as opções de segmentação atribuídas a um pedido de inserção.

Recurso REST: v1.advertisers.invoices

Métodos
list GET /v1/advertisers/{advertiserId}/invoices
Lista as faturas postadas para um anunciante em um determinado mês.
lookupInvoiceCurrency GET /v1/advertisers/{advertiserId}/invoices:lookupInvoiceCurrency
Recupera a moeda da fatura usada por um anunciante em um determinado mês.

Recurso REST: v1.advertisers.lineItems

Métodos
bulkEditLineItemAssignedTargetingOptions POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkEditLineItemAssignedTargetingOptions
Edição em massa de opções de segmentação em um único item de linha.
bulkListLineItemAssignedTargetingOptions GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkListLineItemAssignedTargetingOptions
Lista as opções de segmentação atribuídas a um item de linha nos diferentes tipos de segmentação.
create POST /v1/advertisers/{lineItem.advertiserId}/lineItems
Cria um novo item de linha.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Exclui um item de linha.
generateDefault POST /v1/advertisers/{advertiserId}/lineItems:generateDefault
Cria um novo item de linha com configurações (incluindo segmentação) herdadas do pedido de inserção e um ENTITY_STATUS_DRAFT entity_status.
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}
Recebe um item de linha.
list GET /v1/advertisers/{advertiserId}/lineItems
Lista os itens de linha em um anunciante.
patch PATCH /v1/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
Atualiza um item de linha existente.

Recurso REST: v1.advertisers.lineItems.targetingTypes.assignedTargetingOptions

Métodos
create POST /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Atribui uma opção de segmentação a um item de linha.
delete DELETE /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Exclui uma opção de segmentação atribuída de um item de linha.
get GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Recebe uma única opção de segmentação atribuída a um item de linha.
list GET /v1/advertisers/{advertiserId}/lineItems/{lineItemId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lista as opções de segmentação atribuídas a um item de linha.

Recurso REST: v1.advertisers.locationLists

Métodos
create POST /v1/advertisers/{advertiserId}/locationLists
Cria uma nova lista de locais.
get GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}
Extrai uma lista de locais.
list GET /v1/advertisers/{advertiserId}/locationLists
Lista as listas de locais com base em um determinado ID do anunciante.
patch PATCH /v1/advertisers/{advertiserId}/locationLists/{locationList.locationListId}
Atualiza uma lista de locais.

Recurso REST: v1.advertisers.locationLists.assignedLocations

Métodos
bulkEdit POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations:bulkEdit
Edita várias atribuições em massa entre locais e uma única lista de locais.
create POST /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Cria uma atribuição entre um local e uma lista de locais.
delete DELETE /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations/{assignedLocationId}
Exclui a atribuição entre um local e uma lista de locais.
list GET /v1/advertisers/{advertiserId}/locationLists/{locationListId}/assignedLocations
Lista locais atribuídos a uma lista de locais.

Recurso REST: v1.advertisers.manualTriggers

Métodos
activate POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:activate
Ativa um acionador manual.
create POST /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers
Cria um novo acionador manual.
deactivate POST /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}:deactivate
Desativa um acionador manual.
get GET /v1/advertisers/{advertiserId}/manualTriggers/{triggerId}
Recebe um acionador manual.
list GET /v1/advertisers/{advertiserId}/manualTriggers
Lista acionadores manuais acessíveis ao usuário atual para um determinado ID do anunciante.
patch PATCH /v1/advertisers/{manualTrigger.advertiserId}/manualTriggers/{manualTrigger.triggerId}
Atualiza um acionador manual.

Recurso REST: v1.advertisers.negativeKeywordLists

Métodos
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists
Cria uma nova lista de palavras-chave negativas.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Exclui uma lista de palavras-chave negativas com um ID de anunciante e um ID de lista de palavras-chave negativas.
get GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}
Recebe uma lista de palavras-chave negativas com um ID de anunciante e um ID de lista de palavras-chave negativas.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists
Lista as listas de palavras-chave negativas com base em um determinado ID do anunciante.
patch PATCH /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordList.negativeKeywordListId}
Atualiza uma lista de palavras-chave negativas.

Recurso REST: v1.advertisers.negativeKeywordLists.negativeKeywords

Métodos
bulkEdit POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
Edição em massa de palavras-chave negativas em uma única lista.
create POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Cria uma palavra-chave negativa em uma lista de palavras-chave negativas.
delete DELETE /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords/{keywordValue}
Exclui uma palavra-chave negativa de uma lista de palavras-chave negativas.
list GET /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords
Lista as palavras-chave negativas em uma lista de palavras-chave negativas.
replace POST /v1/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace
Substitui todas as palavras-chave negativas de uma única lista.

Recurso REST: v1.advertisers.targetingTypes.assignedTargetingOptions

Métodos
create POST /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Atribui uma opção de segmentação ao anunciante.
delete DELETE /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Exclui uma opção de segmentação atribuída de um anunciante.
get GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Recebe uma única opção de segmentação atribuída a um anunciante.
list GET /v1/advertisers/{advertiserId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lista as opções de segmentação atribuídas a um anunciante.

Recurso REST: v1.combinedAudiences

Métodos
get GET /v1/combinedAudiences/{combinedAudienceId}
Extrai um público-alvo combinado.
list GET /v1/combinedAudiences
Lista os públicos-alvo combinados.

Recurso REST: v1.customBiddingAlgorithms

Métodos
create POST /v1/customBiddingAlgorithms
Cria um novo algoritmo de lances personalizados.
get GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}
Recebe um algoritmo de lances personalizados.
list GET /v1/customBiddingAlgorithms
Lista algoritmos de lances personalizados acessíveis ao usuário atual e que podem ser usados em estratégias de lances.
patch PATCH /v1/customBiddingAlgorithms/{customBiddingAlgorithm.customBiddingAlgorithmId}
Atualiza um algoritmo de lances personalizados existente.
uploadScript GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}:uploadScript
Cria um objeto de referência do script de lances personalizados para um arquivo de script.

Recurso REST: v1.customBiddingAlgorithms.scripts

Métodos
create POST /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Cria um novo script de lances personalizados.
get GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts/{customBiddingScriptId}
Recebe um script de lances personalizados.
list GET /v1/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
Lista os scripts de lances personalizados que pertencem ao algoritmo especificado.

Recurso REST: v1.customLists

Métodos
get GET /v1/customLists/{customListId}
Recebe uma lista personalizada.
list GET /v1/customLists
Lista listas personalizadas.

Recurso REST: v1.firstAndThirdPartyAudiences

Métodos
create POST /v1/firstAndThirdPartyAudiences
Cria um FirstAndThirdPartyAudience.
editCustomerMatchMembers POST /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}:editCustomerMatchMembers
Atualiza a lista de membros de um público-alvo segmentado por lista de clientes.
get GET /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudienceId}
Recebe um público-alvo próprio e de terceiros.
list GET /v1/firstAndThirdPartyAudiences
Lista públicos-alvo próprios e de terceiros.
patch PATCH /v1/firstAndThirdPartyAudiences/{firstAndThirdPartyAudience.firstAndThirdPartyAudienceId}
Atualiza um FirstAndThirdPartyAudience existente.

Recurso REST: v1.floodlightGroups

Métodos
get GET /v1/floodlightGroups/{floodlightGroupId}
Recebe um grupo do Floodlight.
patch PATCH /v1/floodlightGroups/{floodlightGroup.floodlightGroupId}
Atualiza um grupo do Floodlight.

Recurso REST: v1.googleAudiences

Métodos
get GET /v1/googleAudiences/{googleAudienceId}
Recebe um público-alvo do Google.
list GET /v1/googleAudiences
Lista os públicos-alvo do Google.

Recurso REST: v1.guaranteedOrders

Métodos
create POST /v1/guaranteedOrders
Cria um novo pedido garantido.
editGuaranteedOrderReadAccessors POST /v1/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
Edita os anunciantes lidos de um pedido garantido.
get GET /v1/guaranteedOrders/{guaranteedOrderId}
Recebe um pedido garantido.
list GET /v1/guaranteedOrders
Lista os pedidos garantidos que são acessíveis ao usuário atual.
patch PATCH /v1/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
Atualiza um pedido garantido existente.

Recurso REST: v1.inventorySourceGroups

Métodos
create POST /v1/inventorySourceGroups
Cria um novo grupo de origem de inventário.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}
Exclui um grupo de origem de inventário.
get GET /v1/inventorySourceGroups/{inventorySourceGroupId}
Recebe um grupo de origem de inventário.
list GET /v1/inventorySourceGroups
Lista os grupos de origem de inventário acessíveis ao usuário atual.
patch PATCH /v1/inventorySourceGroups/{inventorySourceGroup.inventorySourceGroupId}
Atualiza um grupo de origem de inventário.

Recurso REST: v1.inventorySourceGroups.assignedInventorySources

Métodos
bulkEdit POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources:bulkEdit
Faz edições em massa em várias atribuições entre origens de inventário e um único grupo de origens de inventário.
create POST /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Cria uma atribuição entre uma origem de inventário e um grupo de origens de inventário.
delete DELETE /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources/{assignedInventorySourceId}
Exclui a atribuição entre uma origem de inventário e um grupo de origens de inventário.
list GET /v1/inventorySourceGroups/{inventorySourceGroupId}/assignedInventorySources
Lista as origens de inventário atribuídas a um grupo de origens de inventário.

Recurso REST: v1.inventorySources

Métodos
create POST /v1/inventorySources
Cria uma nova origem de inventário.
editInventorySourceReadWriteAccessors POST /v1/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors
Edita os acessadores de leitura/gravação de uma origem de inventário.
get GET /v1/inventorySources/{inventorySourceId}
Recebe uma origem de inventário.
list GET /v1/inventorySources
Lista as origens de inventário acessíveis ao usuário atual.
patch PATCH /v1/inventorySources/{inventorySource.inventorySourceId}
Atualiza uma origem de inventário existente.

Recurso REST: v1.media

Métodos
download GET /download/{resourceName=**}
Faz o download de mídia.
upload POST /media/{resourceName=**}
POST /upload/media/{resourceName=**}
Faz upload da mídia.

Recurso REST: v1.partners

Métodos
bulkEditPartnerAssignedTargetingOptions POST /v1/partners/{partnerId}:bulkEditPartnerAssignedTargetingOptions
Edita opções de segmentação em massa em um único parceiro.
get GET /v1/partners/{partnerId}
Recebe um parceiro.
list GET /v1/partners
Lista os parceiros acessíveis ao usuário atual.

Recurso REST: v1.partners.channels

Métodos
create POST /v1/partners/{partnerId}/channels
Cria um novo canal.
get GET /v1/partners/{partnerId}/channels/{channelId}
Extrai um canal para um parceiro ou anunciante.
list GET /v1/partners/{partnerId}/channels
Lista os canais de um parceiro ou anunciante.
patch PATCH /v1/partners/{partnerId}/channels/{channel.channelId}
Atualiza um canal.

Recurso REST: v1.partners.channels.sites

Métodos
bulkEdit POST /v1/partners/{partnerId}/channels/{channelId}/sites:bulkEdit
Edita sites em massa em um único canal.
create POST /v1/partners/{partnerId}/channels/{channelId}/sites
Cria um site em um canal.
delete DELETE /v1/partners/{partnerId}/channels/{channelId}/sites/{urlOrAppId}
Exclui um site de um canal.
list GET /v1/partners/{partnerId}/channels/{channelId}/sites
Lista os sites em um canal.
replace POST /v1/partners/{partnerId}/channels/{channelId}/sites:replace
Substitui todos os sites em um único canal.

Recurso REST: v1.partners.targetingTypes.assignedTargetingOptions

Métodos
create POST /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Atribui uma opção de segmentação a um parceiro.
delete DELETE /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Exclui uma opção de segmentação atribuída de um parceiro.
get GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions/{assignedTargetingOptionId}
Recebe uma única opção de segmentação atribuída a um parceiro.
list GET /v1/partners/{partnerId}/targetingTypes/{targetingType}/assignedTargetingOptions
Lista as opções de segmentação atribuídas a um parceiro.

Recurso REST: v1.sdfdownloadtasks

Métodos
create POST /v1/sdfdownloadtasks
Cria uma tarefa de download de SDF.

Recurso REST: v1.sdfdownloadtasks.operations

Métodos
get GET /v1/{name=sdfdownloadtasks/operations/*}
Recebe o estado mais recente de uma operação de tarefa de download de SDF assíncrona.

Recurso REST: v1.targetingTypes.targetingOptions

Métodos
get GET /v1/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}
Recebe uma única opção de segmentação.
list GET /v1/targetingTypes/{targetingType}/targetingOptions
Lista as opções de segmentação de um determinado tipo.
search POST /v1/targetingTypes/{targetingType}/targetingOptions:search
Pesquisa opções de segmentação de um determinado tipo com base nos termos de pesquisa informados.

Recurso REST: v1.users

Métodos
bulkEditAssignedUserRoles POST /v1/users/{userId}:bulkEditAssignedUserRoles
Edição em massa de funções de usuários.
create POST /v1/users
Cria um novo usuário.
delete DELETE /v1/users/{userId}
Exclui um usuário.
get GET /v1/users/{userId}
Extrai um usuário.
list GET /v1/users
Lista os usuários acessíveis ao usuário atual.
patch PATCH /v1/users/{user.userId}
Atualiza um usuário existente.