Notas da versão

Esta página fornece notas da versão para as APIs Display e API Video 360.

Versão mais recente da API: v3

15 de julho de 2024

Novos recursos

Agora é possível fazer o download de arquivos de dados estruturados do item de linha e do grupo de anúncios em Formato do controle de qualidade na v3.

v3

  • Os seguintes campos foram adicionados:

    RecursoCampo(s)
    IdFilter

    adGroupQaIds

    lineItemQaIds

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

17 de junho de 2024

Novos recursos

Agora é possível gerenciar a segmentação por palavras-chave atribuída no nível do anunciante.

Adição do novo campo optimizationObjective ao pedido de inserção recurso. O optimizationObjective só está disponível para clientes na lista de permissões.

v3

v2

30 de maio de 2024

Novos recursos

Foi adicionado suporte para os arquivos de dados estruturados (SDF, na sigla em inglês) versão 7.1.

v3

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    SdfVersion

    SDF_VERSION_7_1

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    SdfVersion

    SDF_VERSION_7_1

23 de abril de 2024

Novos recursos

Foi adicionado suporte a novos tipos de KPI, trocas e plataformas de apps.

v3

  • Os seguintes campos foram adicionados:

    RecursoCampo(s)
    KPIs

    kpiAlgorithmId

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV
    Troca

    EXCHANGE_DRAX
    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10
    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 de fevereiro de 2024

Novos recursos

Agora é possível remover explicitamente membros dos públicos-alvo segmentados por lista de clientes.

Agora é possível segmentar novas trocas.

v3

v2

29 de janeiro de 2024

Novos recursos

Adicionada a capacidade de recuperar atividades do Floodlight por meio de uma nova serviço floodlightGroups.floodlightActivities.

Adicionado um novo campo para informar se um cliente do YouTube Item de linha do Google Partners inclui inventário do Google TV na segmentação.

Um novo campo foi adicionado para redirecionar a hora do último login para uma conta do Display & Google Video 360 usuário.

v3

v2

14 de novembro de 2023

Novos recursos

Agora é possível transmitir o consentimento do usuário final durante o upload da Segmentação por lista de clientes. os membros do público em todas as versões ao vivo.

v3

v2

31 de outubro de 2023

Novos recursos

A v3 saiu da versão Beta pública e agora está em disponibilidade geral.

Renomeação de um valor de tipo enumerado AdGroupFormat na v3 para maior precisão. refletem o formato relevante.

Adicionado suporte para arquivos de dados estruturados v7 com a adição do Valor de enumeração SDF_VERSION_7 nas v2 e v3.

v3

  • Os seguintes valores de tipo enumerado foram removidos:

    EnumeraçãoValores
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE
    SdfVersion

    SDF_VERSION_7

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    SdfVersion

    SDF_VERSION_7

2 de outubro de 2023

Novos recursos

A v3 foi lançada na versão Beta pública, que inclui as seguintes mudanças:

Siga as etapas do nosso guia de migração para migrar da v2 para a v3.

Foi adicionado suporte para três novos valores LineItemType, um novo. YoutubeAndPartnersBiddingStrategyType e uma nova PartnerCostType nas versões 2 e 3.

v3

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE
    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 de agosto de 2023

Novos recursos

Agora é possível usar duas trocas e duas novas opções YouTube & Parceiros tipos de estratégia de lances.

Adicionado um novo campo effectiveContentCategory ao YouTube & aos parceiros para mostrar YoutubeAndPartnersContentCategory usados pelo item de linha ao considerando os valores atribuídos no nível do anunciante e do item de linha.

v2

5 de junho de 2023

Novos recursos

Adicionamos um novo valor SdfVersion para arquivos de dados estruturados (SDF) v6 na v1 e v2.

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    SdfVersion

    SDF_VERSION_6

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    SdfVersion

    SDF_VERSION_6

9 de março de 2023

Novos recursos

Um novo valor de LineItemWarningMessage será adicionado atribuído ao campo warningMessages de um item de linha se ele tiver o campo descontinuado excludeFirstPartyAudience definido como true O campo excludeFirstPartyAudience será desativado e defina como false após 25 de março de 2023.

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 de fevereiro de 2023

Novos recursos

Foi adicionada a capacidade de recuperar YouTubeAdGroup e YouTubeAdGroupAd, bem como Grupo de anúncios do YouTube a segmentação por recursos. Além disso, também adicionamos novos tipos de segmentação recuperáveis usados nos grupos de anúncios do YouTube nível Leia nossa nova página de guia sobre como recuperar o YouTube e Parceiros recursos para mais informações.

Suporte adicionado para mais quatro trocas nas v1 e v2.

v2

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    EnumeraçãoValores
    Troca

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 de dezembro de 2022

Novos recursos

A v2 saiu da versão Beta pública e agora está em disponibilidade geral.

Adicionamos um novo campo assignedTargetingOptionIdAlias ao AssignedTargetingOption, que pode ser usado no lugar do assignedTargetingOptionId ao recuperar e excluir a segmentação. Este campo só é definido para opções de segmentação atribuídas de tipos de segmentação que são atribuídos por tipo enumerado. O valor de alias é o valor de tipo enumerado relevante como uma string.

Adicionamos um novo campo billingConfig ao Advertiser.

Adicionado suporte à recuperação do YouTube e os parceiros em itens de linha over-the-top, identificado por três novos valores de LineItemType.

Aumento do tamanho máximo da página para 200 em vários métodos list nas v1 e v2. O o tamanho de página padrão não foi alterado.

v2

v1

Problemas conhecidos

Esta atualização corrige os seguintes problemas conhecidos na v2:

27 de outubro de 2022

Adicionou a capacidade de duplicar um item de linha existente no elemento pai InsertionOrder.

Introduziu suporte de gravação de segmentação de ordem de inserção parcial para um subconjunto de de segmentação com a adição de create e delete ao advertisers.insertionOrders.targetingTypes.assignedTargetingOptions serviço.

Novos recursos

v2

v1

Nenhum recurso novo foi adicionado à v1.

20 de setembro de 2022

A v2 foi lançada na versão Beta pública, que inclui as seguintes mudanças:

Siga as etapas do nosso guia de migração para migrar da v1 para a v2.

Foi adicionado suporte para três novas trocas na v1.

Novos recursos

v2

Veja a seguir uma lista de alterações entre a v1 e a v2:

v1

  • Os seguintes valores de tipo enumerado foram adicionados à v1:

    EnumeraçãoValores
    Troca

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 de maio de 2022

Adicionada a capacidade de criar recursos InventorySource e gerenciar recursos da GuaranteedOrder por meio das novas inventorySources e uma nova guaranteedOrders.

O campo modelReadiness foi introduzido à CustomBiddingAlgorithm. Esse campo lista a prontidão o modelo do algoritmo para cada anunciante que pode acessá-lo.

Foi ativada a nova funcionalidade de parâmetro de consulta filter para o método advertisers.creatives.list, que permite ao usuário para recuperar somente criativos com um updateTime antes ou depois de um carimbo de data/hora.

Foi adicionado suporte para a versão mais recente do SDF, v5.5, por meio da Adição de um valor de enumeração SdfVersion.

Novos recursos

31 de março de 2022

Foi adicionado suporte para a recuperação e definição da segmentação em a duração do conteúdo, o tipo de transmissão; e genre.

O campo billableOutcome foi adicionado ao InsertionOrder objeto.

O campo raiseBidForDeals foi introduzido à MaximizeSpendBidStrategy, permitindo que os usuários definam se o lance aplica os preços mínimos do anunciante para as transações segmentadas.

Novos recursos

2 de fevereiro de 2022

Foi adicionado suporte para criação, atualização e editar membros de uma determinada Segmentação por lista de clientes FirstAndThirdPartyAudience. O Fazer o upload de públicos-alvo segmentados por lista de clientes na nova O guia Usar públicos-alvo detalha como usar esses novos recursos.

Um novo campo reservationType foi introduzido em InsertionOrder e LineItem recursos que identificam se um recurso é programática garantida por tags Garantido ou não garantido.

Foi adicionada a capacidade de recuperar e definir se um item de linha segmenta automaticamente novas trocas usando um novo excludeNewExchanges .

Além dos novos recursos, os limites de cota padrão foram dobrados.

Novos recursos

9 de dezembro de 2020 .

Foi adicionado suporte à segmentação por tipo de conteúdo de áudio no tipo de segmentação. TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Novos recursos

8 de novembro de 2021

Adição de suporte completo para o gerenciamento de algoritmos de lances personalizados e seus scripts. Isso inclui:

Uma nova página Implementar lances personalizados foi adicionada ao nosso guia de Gerenciamento de itens de linha que descreve processo de criação de um algoritmo de lances personalizados, upload de um script e atribuindo o algoritmo de lances personalizados como a estratégia de lances de um item de linha.

Foi adicionado suporte para a versão mais recente do SDF, v5.4, pela Adição de um valor de enumeração SdfVersion.

Novos recursos

14 de setembro de 2021

Adição de suporte para a área de segmentação por proximidade em tipos de segmentação TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI.

Foi adicionada a capacidade de pesquisar por TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI opções de segmentação usando targetingTypes.targetingOptions.search, já que não podem ser recuperados via targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Os novos sharedAdvertiserIds e Campos customBiddingAlgorithmState para o lance personalizado um recurso de algoritmo e mais suporte para o Tipo de algoritmo de lances personalizados GOAL_BUILDER_BASED.

Foram adicionados dois novos valores ao tipo enumerado Exchange.

Novos recursos

4 de agosto de 2021

Agora é possível usar o Open Measurement ativado segmentação de inventário no tipo de segmentação TARGETING_TYPE_OMID.

Aumento do número máximo de opções de segmentação atribuídas que podem ser retornadas em uma única página de vários anunciantes, campanhas, segmentação atribuída a pedido de inserção e item de linha métodos de lista de opções usando o parâmetro do método pageSize.

Novos recursos

26 de maio de 2021

Lançamento do serviço advertisers.invoices, que permite usuários:

  • recuperar faturas emitidas para um anunciante durante um determinado mês.
  • pesquisar o código da moeda usado por um anunciante durante um determinado mês.

O campo campaignBudgets foi adicionado à campanha recurso. Os segmentos de orçamento do pedido de inserção podem ser vinculados a um orçamento de campanha, restringindo o orçamento total do segmentos associados ao valor total do orçamento da campanha.

Adicionado suporte para segmentação por posição de conteúdo nativo na nova tipo de segmentação TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Um novo campo prismaEnabled foi introduzido para o anunciante. permitindo que os usuários habilitem a integração com a ferramenta Prisma da Mediaocean.

Ativação do suporte ao valor de tipo enumerado ENTITY_STATUS_PAUSED para o No campo entityStatus do anunciante.

Novos recursos

29 de abril de 2021

Adicionados novos campos a Channel e Recursos de lista de palavras-chave negativas que retornam a contagem de linhas usando o recurso para segmentação. Novo filter ativado para o método de lista de itens de linha que permitem ao usuário recuperar somente os itens de linha que estão usando canais específicos ou palavras-chave negativas listas na segmentação.

Novos recursos

30 de março de 2021

Adicionado um novo método ao serviço de item de linha que gera uma com as configurações padrão. Esses valores padrão são baseados tipo de item de linha fornecido, bem como as configurações e atribuições a segmentação do pedido de inserção pai.

Permitiu a recuperação da segmentação da campanha por meio de uma novo serviço de segmentação de campanhas e método adicional de lista em massa.

Segmentação por apps expandida para permitir a segmentação de apps. em mais plataformas.

Foram feitas várias alterações em advertisers.channels.sites, partners.channels.sites e advertisers.negativeKeywordLists.negativeKeywords serviços para permitir um gerenciamento mais fácil do conteúdo da lista de canais e palavras-chave negativas. Esses incluem:

  • A adição de métodos replace, que permite ao usuário substituir completamente a conteúdos existentes de um canal ou de uma lista de palavras-chave negativas.
  • Remoção do requisito de que itens sejam incluídos no createdSites ou createdNegativeKeywords campos de edição em massa solicitações.
  • Aumento do número máximo de itens que podem ser retornados em uma única página de uma lista de sites ou Listar palavras-chave negativas

Novos recursos

Suspensões de uso

24 de fevereiro de 2021

Lançamos um novo serviço de segmentação de pedidos de inserção e método adicional de lista em massa que permite a recuperação de de anúncios atribuída a pedidos de inserção. Ampliou o recurso do criativo, adicionando campos de criativos somente de saída para uso criativos em áudio de terceiros. Adição de novos tipos de meta de performance para uso por pedido de inserção e campanha do Google Cloud.

Novos recursos

27 de janeiro de 2021

Permitiu a recuperação e o gerenciamento de pedidos de inserção de TV e de linha over-the-top itens por meio da introdução de uma novo campo InsertOrderType e um novo valor de enumeração OrderType. Agora é possível usar apps para dispositivos móveis. por um campo de item de linha mobileApp. Troca expandida, público-alvo do Google e Suporte a SDF por meio de outros valores de tipo enumerado. Apresentou o capacidade de filtrar e ordenar advertisers.list valores pelo horário da última atualização.

Novos recursos

4 de dezembro de 2020

Adicionada a capacidade de pesquisar Opções de segmentação por região geográfica e filtrar vários recursos liste os resultados do método pelo horário da última atualização. Introdução de um new OrderWarningMessage para informar os usuários sobre quando um está usando uma segmentação geográfica descontinuada.

Novos recursos

5 de novembro de 2020

Capacidade adicionada para criar, atribuir e ativar acionadores manuais que iniciam os itens de linha associados e reduzir os gastos. Introdução das opções de expansão de segmentação que, quando definido, pode expandir a segmentação de um item de linha para incluir usuários semelhantes a e aqueles em públicos-alvo. Anexaram campos de ID do segmento personalizado a DoubleVerify e Integral Ad Science objetos usados segmentação por verificação de terceiros.

Novos recursos

12 de outubro de 2020

Mensagens de aviso recuperáveis foram introduzidas ao item de linha. recurso e um tipo de meta de desempenho da taxa de cliques (CTR). Adicionada warningMessages como um campo filtrável ao listar itens de linha.

Além dos novos recursos, novos limites de cota estão em vigor e A nova documentação sobre como usar solicitações em lote está disponível.

Novos recursos

28 de agosto de 2020

Adicionados novos campos à resposta do método de auditoria do anunciante e novos campos filtráveis para vários métodos de lista.

Novos recursos

4 de agosto de 2020

Lançamento dos novos serviços de gerenciamento de usuários, parceiros e segmentação de parceiros. Introduzimos ferramentas para ajudar os usuários a evitar atingir, de forma proativa, os limites de entidades da conta. Compatibilidade adicionada para itens de linha de áudio e uso de algoritmos de lances personalizados em estratégias de lances de itens de linha e pedido de inserção.

Novos recursos

24 de junho de 2020

Lançamento de uma pequena atualização que adiciona um método de criação para canais de parceiro e anunciante, novos campos FirstAndThirdPartyAudience e outros valores de tipo enumerado de troca.

Novos recursos

2 de junho de 2020

Introduziu a capacidade de criar, corrigir e preencher um subconjunto de entidades segmentáveis e adicionou a capacidade de modificar a segmentação no nível do anunciante para três tipos de segmentação: canal, exclusão de classificação de conteúdo digital e exclusão de categoria sensível.

Novos recursos

27 de abril de 2020

Um grande conjunto de recursos foi lançado, expandindo o escopo da API para além dos SDFs. Adicionada gerenciamento de recursos principais que permite criar, recuperar, atualizar e excluir entidades como anunciantes, campanhas, pedidos de inserção, itens de linha e criativos. Os novos recursos também permitem a edição da segmentação no nível do item de linha.

Novos recursos

Os seguintes serviços foram adicionados:

ServiçoMétodos
anunciantes

criar

excluir

receba

lista

patch
advertisers.assets

enviar
advertisers.campaigns

criar

excluir

receba

lista

patch
advertisers.channels

receba

lista
advertisers.creatives

criar

excluir

receba

lista

patch
advertisers.insertionOrders

criar

excluir

receba

lista

patch
advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

criar

excluir

receba

lista

patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions

criar

excluir

receba

lista
advertisers.locationLists

receba

lista
advertisers.negativeKeywordLists

receba

lista
combinedAudiences

receba

lista
customLists

receba

lista
firstAndThirdPartyAudiences

receba

lista
floodlightGroups

receba

patch
googleAudiences

receba

lista
inventorySourceGroups

receba

lista
inventorySources

receba

lista
partners.channels

receba

lista
partners.channels

receba

lista

9 de março de 2020

Lançamento de anúncios de display e API Video 360 v1. Esta é a versão inicial da API.

Problemas conhecidos

Nenhum.