Esta página mostra notas da versão para versões desativadas da API Display & Video 360.
Acesse nossa página principal de notas da versão para conferir todas as versões em produção.
4 de dezembro de 2024
Novos recursos
Adição de suporte aos valores Exchange do Core e do Tubi.
Aumentamos o tamanho máximo permitido da página para
firstAndThirdPartyAudiences.list de 200 para 5000. Atualize o parâmetro pageSize das suas solicitações firstAndThirdPartyAudiences.list para otimizar ainda mais o uso da cota.
v3
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores ExchangeEXCHANGE_COREEXCHANGE_TUBIO tamanho máximo da página foi aumentado para os seguintes métodos de lista:
Método Novo tamanho máximo da página firstAndThirdPartyAudiences.list5000
22 de outubro de 2024
Novos recursos
Adicionamos suporte à meta de performance de custo por visualização.
Adicionamos a capacidade de definir e recuperar a segmentação de dispositivos conectados.
Adicionamos novas configurações de brand safety da Adloox em Segmentação de verificador terceirizado.
Adicionamos suporte para o download de arquivos de dados estruturados v8, que está atualmente em versão Beta fechada.
v3
Estes campos foram adicionados:
Objeto Campo(s) AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentOs seguintes valores de enumeração foram adicionados:
Enumeração Valores DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Valores descontinuados
A compatibilidade com o SDF v5.5 foi removida devido à desativação em 3 de outubro de 2024.
v3
Os seguintes valores de enumeração foram descontinuados:
Enumeração Valores SdfVersionSDF_VERSION_5_5
15 de agosto de 2024
Novos recursos
Adição de compatibilidade com o tipo Exchange da Netflix.
v3
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_NETFLIX
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_NETFLIX
15 de julho de 2024
Novos recursos
Adicionamos suporte para o download de arquivos de dados estruturados de itens de linha e grupos de anúncios no formato QA na v3.
v3
Estes campos foram adicionados:
Recurso Campo(s) IdFilter Os seguintes valores de enumeração foram adicionados:
Enumeração Valores FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 de junho de 2024
Novos recursos
Adicionamos suporte para gerenciar a segmentação por palavras-chave atribuída no nível do anunciante.
Adição de um novo campo optimizationObjective ao recurso de pedido de inserção. O optimizationObjective está disponível apenas para clientes na lista de permissões.
v3
Estes campos foram adicionados:
Recurso Campo(s) InsertionOrder Os seguintes métodos agora são compatíveis com os tipos de segmentação a seguir:
Tipo de segmentação Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Os seguintes métodos agora são compatíveis com os tipos de segmentação a seguir:
Tipo de segmentação Métodos TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 de maio de 2024
Novos recursos
Adicionamos suporte à versão 7.1 dos arquivos de dados estruturados (SDF).
v3
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion SDF_VERSION_7_1
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion SDF_VERSION_7_1
23 de abril de 2024
Novos recursos
Adição de suporte a novos tipos de KPI, exchanges e plataformas de apps.
v3
Estes campos foram adicionados:
Recurso Campo(s) Kpi Os seguintes valores de enumeração foram adicionados:
Enumeração Valores 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
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Troca EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 de fevereiro de 2024
Novos recursos
Agora é possível remover membros dos públicos-alvo segmentados por lista de clientes.
Adição de suporte para segmentação de novas bolsas.
v3
Estes campos foram adicionados:
Recurso Campo(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Estes campos foram adicionados:
Recurso Campo(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 de janeiro de 2024
Novos recursos
Adicionamos a capacidade de recuperar atividades do Floodlight usando um novo serviço
floodlightGroups.floodlightActivities.
Adicionamos um novo campo que informa se um item de linha do YouTube e parceiros inclui o inventário do Google TV na segmentação.
Adicionamos um novo campo para transmitir a última hora de login de um usuário do Display & Video 360.
v3
Os seguintes métodos foram adicionados:
Serviço Métodos floodlightGroups.floodlightActivities Estes campos foram adicionados:
Recurso Campo(s) Usuário YoutubeAndPartnersInventorySourceConfig
v2
Os seguintes métodos foram adicionados:
Serviço Métodos floodlightGroups.floodlightActivities Estes campos foram adicionados:
Recurso Campo(s) Usuário YoutubeAndPartnersInventorySourceConfig
14 de novembro de 2023
Novos recursos
Adicionamos suporte para transmitir o consentimento do usuário final ao fazer upload de membros do público-alvo da Segmentação por lista de clientes em todas as versões ativas.
v3
Estes campos foram adicionados:
Recurso Campo(s) ContactInfoList MobileDeviceIdList
v2
Estes campos foram adicionados:
Recurso Campo(s) ContactInfoList MobileDeviceIdList
31 de outubro de 2023
Novos recursos
A v3 saiu da versão Beta pública e está em disponibilidade geral.
Renomeamos um valor de enumeração AdGroupFormat na v3 para refletir com mais precisão o formato relevante.
Adicionamos suporte para arquivos de dados estruturados v7 com a inclusão do valor de enumeração SDF_VERSION_7 nas versões 2 e 3.
v3
Os seguintes valores de enumeração foram removidos:
Enumeração Valores AdGroupFormat AD_GROUP_FORMAT_ACTION
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion SDF_VERSION_7
2 de outubro de 2023
Novos recursos
Lançamento da v3 na versão Beta pública, que inclui as seguintes mudanças:
- A capacidade de gerenciar totalmente as listas de locais por proximidade, permitindo o uso do serviço
advertisers.locationLists.assignedLocationspara criar e excluir locais atribuídos a recursos deTARGETING_LOCATION_TYPE_PROXIMITYLocationList. - Um novo campo booleano
enableOptimizedTargeting, que substitui o campotargetingExpansionLevelno objetoTargetingExpansionConfig. - O requisito do campo
billingConfigno recursoAdvertiser, que precisa ser incluído ao fazer solicitaçõesadvertisers.create, e um novo campobillingConfigno recursoPartner(links em inglês). - Novos recursos
AdGroupeAdGroupAdque substituem os recursosYoutubeAdGroupeYoutubeAdGroupAdna v2.
Siga as etapas do nosso guia de migração para migrar da v2 para a v3.
Adicionamos suporte a três novos valores de LineItemType, um novo YoutubeAndPartnersBiddingStrategyType e um novo PartnerCostType nas versões 2 e 3.
v3
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Os seguintes métodos foram removidos:
Serviço Métodos advertisers.manualTriggers ativar
create
desativar
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
O comportamento do seguinte método mudou:
Método Mudança(s) advertisers.locationLists.create Agora é possível criar recursos TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.patch Agora é possível atualizar recursos TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.bulkEdit Agora é possível editar em massa os recursos AssignedLocationnos recursosTARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.assignedLocations.create Agora é possível criar recursos AssignedLocationem recursosTARGETING_LOCATION_TYPE_PROXIMITYLocationList.Os seguintes parâmetros de consulta foram adicionados:
Método Parâmetro(s) inventorySources.get Os campos a seguir agora são obrigatórios:
Recurso Campo(s) Anunciante Estes campos foram adicionados:
Recurso Campo(s) BiddingStrategy InsertionOrder Parceiro TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Os seguintes campos foram removidos:
Recurso Campo(s) InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores CustomBiddingAlgorithmType RULE_BASED
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
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Os seguintes valores de enumeração foram removidos:
Enumeração Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores 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
Adicionamos suporte a duas bolsas de valores e dois novos tipos de estratégia de lances do YouTube e parceiros.
Adicionamos um novo campo effectiveContentCategory aos itens de linha do YouTube e parceiros para mostrar o YoutubeAndPartnersContentCategory usado pelo item de linha ao considerar valores atribuídos no nível do anunciante e do item de linha.
v2
Estes campos foram adicionados:
Recurso Campo(s) YoutubeAndPartnersSettings Os seguintes campos foram removidos:
Recurso Campo(s) InventorySource subSitePropertyId
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 de junho de 2023
Novos recursos
Adicionamos um novo valor SdfVersion para arquivos de dados estruturados (SDF) v6 nas versões 1 e 2.
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion SDF_VERSION_6
v1
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion SDF_VERSION_6
9 de março de 2023
Novos recursos
Adição de um novo valor LineItemWarningMessage que será atribuído ao campo warningMessages de um item de linha se ele tiver o campo excludeFirstPartyAudience descontinuado definido como true. O campo excludeFirstPartyAudience será desativado e definido como false após 25 de março de 2023.
v2
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 de fevereiro de 2023
Novos recursos
Adicionamos a capacidade de recuperar recursos YouTubeAdGroup e YouTubeAdGroupAd, além da segmentação de recursos do grupo de anúncios do YouTube. Além disso, adicionamos novos tipos de segmentação recuperáveis usados no nível dos grupos de anúncios do YouTube. Leia nossa nova página de guia sobre como recuperar recursos do YouTube e parceiros para mais informações.
Adicionamos suporte para mais quatro trocas nas versões 1 e 2.
v2
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Estes campos foram adicionados:
Serviço Métodos AssignedTargetingOption YoutubeAndPartnersSettings Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Troca EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Os seguintes valores de enumeração foram adicionados:
Enumeração Valores 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 está disponível para todos os usuários.
Adicionamos um novo campo assignedTargetingOptionIdAlias ao recurso
AssignedTargetingOption, que pode ser usado no lugar de
assignedTargetingOptionId ao recuperar e excluir a segmentação.
Esse campo só é definido para opções de segmentação atribuídas de tipos de segmentação que
são atribuídos por enumeração. O valor do alias é o valor do enum relevante como uma string.
Adicionamos um novo campo billingConfig ao recurso Advertiser.
Adição de suporte para recuperação de itens de linha over-the-top do YouTube e parceiros, identificados por três novos valores LineItemType.
Aumentamos o tamanho máximo da página para 200 em vários métodos list nas versões 1 e 2. O tamanho de página padrão não muda.
v2
Estes campos foram adicionados:
Recurso Campo(s) Anunciante AssignedTargetingOption Os seguintes valores de enumeração foram adicionados:
Enumeração Valores LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
O tamanho máximo da página foi aumentado para os seguintes métodos de lista:
v1
O tamanho máximo da página foi aumentado para os seguintes métodos de lista:
Problemas conhecidos
Esta atualização corrige os seguintes problemas conhecidos na v2:
- As opções de segmentação atribuídas de tipos de segmentação atribuídos usando valores de enumeração na v2 não podiam ser removidas ou recuperadas usando o
assignedTargetingOptionId. Em vez disso, esperava-se que os usuários usassem o valor de enumeração. Com essa atualização, as opções de segmentação atribuídas podem ser removidas ou recuperadas usando oassignedTargetingOptionIdou o valor de enumeração, identificado pelo novo campoassignedTargetingOptionIdAliasno recursoAssignedTargetingOption. - A solicitação do item de linha
bulkUpdatenão usou corretamente o parâmetro de solicitaçãoadvertisersId, retornando um erro. Com essa atualização, o método foi corrigido e o parâmetro de solicitação foi renomeado deadvertisersIdparaadvertiserId.
27 de outubro de 2022
Foi adicionada a capacidade de duplicar um item de linha na InsertionOrder principal.
Foi introduzido o suporte parcial de gravação de segmentação de pedido de inserção para um subconjunto de tipos de segmentação com a adição dos métodos create e delete ao serviço advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.
Novos recursos
v2
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Nenhum novo recurso foi adicionado à v1.
20 de setembro de 2022
Lançamento da v2 na versão Beta pública, que inclui as seguintes mudanças:
- A capacidade de recuperar itens de linha do YouTube e parceiros e as configurações de segmentação deles usando os métodos
getelistnos serviçosadvertisers.lineItemseadvertisers.lineItems.targetingTypes.assignedTargetingOptions. - Dois novos métodos de segmentação em massa no serviço
advertisers.lineItemsque permitem editar e recuperar a segmentação atribuída em vários itens de linha com uma única solicitação. - Um novo método
bulkUpdateque permite aos usuários atualizar oentityStatusde vários itens de linha em uma única solicitação. - Nova lógica de segmentação que exige que recursos
AssignedTargetingOptionde um subconjunto de tipos de segmentação sejam atribuídos e recuperados usando valores de enumeração em vez de IDs de opção de segmentação recuperados usando o serviçotargetingTypes.targetingOptions.
Siga as etapas do nosso guia de migração para migrar da v1 para a v2.
Adição de suporte para três novas trocas na v1.
Novos recursos
v2
Confira a seguir uma lista de mudanças entre a v1 e a v2:
Os seguintes métodos foram adicionados na v2:
Serviço Métodos advertisers.lineItems bulkEditAssignedTargetingOptions
Os seguintes métodos foram removidos na v2:
Serviço Métodos advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Os seguintes métodos foram renomeados na v2:
Serviço Nome do método antigo Novo nome do método advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions parceiros bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Os recursos
AssignedTargetingOptiondos seguintes tipos de segmentação usam enums para atribuição de segmentação na v2. O campoassignedTargetingOptionIdpara recursosAssignedTargetingOptiondesses tipos de segmentação também foi atualizado na v2 para usar versões de string dos valores de enumeração:Tipo de segmentação Tipo de enumeração TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Ambiente TARGETING_TYPE_EXCHANGE Troca TARGETING_TYPE_GENDER Gênero TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilidade Os seguintes campos foram adicionados na v2:
Os seguintes campos foram removidos na v2:
Os campos a seguir se tornaram obrigatórios na v2:
Os seguintes valores de enumeração foram adicionados na v2:
Enumeração Valores AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Troca EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Os seguintes valores de enumeração foram removidos na v2:
Enumeração Valores LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Os seguintes valores de enumeração foram adicionados na v1:
Enumeração Valores Troca EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 de maio de 2022
Adicionamos a capacidade de criar recursos InventorySource e gerenciar recursos GuaranteedOrder usando novos métodos de gravação do serviço inventorySources e um novo serviço guaranteedOrders.
Introduzimos o campo modelReadiness no
recurso CustomBiddingAlgorithm. Esse campo lista a prontidão do modelo do algoritmo para cada anunciante que pode acessar.
Ativamos a nova funcionalidade do parâmetro de consulta filter para
o método advertisers.creatives.list, que permite ao usuário
recuperar apenas criativos com um updateTime
antes ou depois de um determinado carimbo de data/hora.
Adicionamos suporte à versão mais recente do SDF, v5.5, com a inclusão de um valor de enumeração SdfVersion.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos guaranteedOrders inventorySources Estes campos foram adicionados:
Recurso Campo(s) CustomBiddingAlgorithm InventorySource Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion Os seguintes métodos de lista agora podem ser filtrados pelas propriedades a seguir:
Método Campo(s) advertisers.creatives.list
31 de março de 2022
Adição de suporte para recuperação e definição de segmentação por duração do conteúdo, tipo de stream e gênero.
Adicionamos o campo billableOutcome ao objeto InsertionOrder.
Introduzimos o campo raiseBidForDeals ao objeto
MaximizeSpendBidStrategy, permitindo que os usuários definam se a estratégia de lances
aplica preços mínimos do anunciante para transações segmentadas.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Os seguintes valores de enumeração foram adicionados:
Enumeração Valores TargetingType
2 de fevereiro de 2022
Inclusão de suporte para criar, atualizar e
editar membros de determinados recursos de
FirstAndThirdPartyAudience Segmentação por lista de clientes. A página Fazer upload de públicos-alvo de Segmentação por lista de clientes no novo guia Usar públicos-alvo detalha como usar esses novos recursos.
Introduzimos um novo campo reservationType nos recursos
InsertionOrder e LineItem
que identifica se um recurso é garantido por tag, garantido de forma programática ou não garantido.
Foi adicionada a capacidade de recuperar e definir se um item de linha segmenta automaticamente
novas trocas usando um novo campo excludeNewExchanges.
Além dos novos recursos, os limites de cota padrão foram dobrados.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos firstAndThirdPartyAudiences Estes campos foram adicionados:
Recurso Campo(s) FirstAndThirdPartyAudience InsertionOrder LineItem
9 de dezembro de 2020 .
Adicionamos suporte à segmentação por tipo de conteúdo de áudio no tipo de segmentação
TARGETING_TYPE_AUDIO_CONTENT_TYPE.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption TargetingOption Os seguintes valores de enumeração foram adicionados:
Enumeração Valores TargetingType
8 de novembro de 2021
Adição de suporte completo para gerenciar algoritmos de lances personalizados e os scripts deles. Isso inclui:
- Funções para criar e atualizar
customBiddingAlgorithms. - A capacidade de fazer upload de scripts pelo processo de recuperar um local de recurso disponível e depois fazer upload do arquivo para esse local.
- Um novo serviço
customBiddingAlgorithms.scriptspara recuperar e criarcustomBiddingScripts.
Uma nova página Implementar lances personalizados foi adicionada ao guia Gerenciar itens de linha, que descreve o processo de criação de um algoritmo de lances personalizados, upload de um script e atribuição do algoritmo como estratégia de lances de um item de linha.
Adicionamos suporte à versão mais recente do SDF, v5.4, com a inclusão de um valor de enumeração SdfVersion.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos customBiddingAlgorithms customBiddingAlgorithms.scripts media Os seguintes valores de enumeração foram adicionados:
Enumeração Valores SdfVersion
14 de setembro de 2021
Adicionamos suporte à segmentação por proximidade em tipos de segmentação
TARGETING_TYPE_BUSINESS_CHAIN e
TARGETING_TYPE_POI.
Adicionamos a capacidade de pesquisar opções de segmentação de
TARGETING_TYPE_BUSINESS_CHAIN e
TARGETING_TYPE_POI disponíveis usando
targetingTypes.targetingOptions.search, já que não podem ser
recuperadas pelos métodos targetingTypes.targetingOptions.get ou
targetingTypes.targetingOptions.list.
Introduzimos os novos campos sharedAdvertiserIds e customBiddingAlgorithmState ao recurso de algoritmo de lances personalizados e adicionamos suporte ao tipo de algoritmo de lances personalizados GOAL_BUILDER_BASED.
Adicionamos dois novos valores à enumeração Exchange.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Corpo da solicitação TargetingOptions.search Os seguintes valores de enumeração foram adicionados:
Enumeração Valores CustomBiddingAlgorithmType Troca TargetingType Os seguintes métodos de lista agora podem ser filtrados pelas propriedades a seguir:
Método Campo(s) customBiddingAlgorithms.list
4 de agosto de 2021
Adicionamos suporte à segmentação de inventário ativada para Open Measurement no tipo de segmentação TARGETING_TYPE_OMID.
Aumentamos o número máximo de opções de segmentação atribuídas que podem ser retornadas em uma única página de vários métodos de lista de opções de segmentação atribuídas de anunciante, campanha, pedido de inserção e item de linha usando o parâmetro de método pageSize.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption TargetingOption Os seguintes valores de enumeração foram adicionados:
Enumeração Valores TargetingType O tamanho máximo da página foi aumentado para os seguintes métodos de lista:
26 de maio de 2021
Lançamos o serviço advertisers.invoices, que permite aos
usuários:
- recuperar faturas emitidas para um anunciante durante um determinado mês.
- pesquisar o código da moeda usada por um anunciante durante um determinado mês.
Adicionamos o campo campaignBudgets ao recurso de campanha. Os segmentos de orçamento do pedido de inserção podem ser vinculados a um orçamento de campanha, restringindo o orçamento total dos segmentos associados ao valor total do orçamento da campanha.
Adicionamos suporte à segmentação por posição de conteúdo nativo no novo tipo de segmentação TARGETING_TYPE_NATIVE_CONTENT_POSITION.
Adicionamos um novo campo prismaEnabled ao recurso "Anunciante", permitindo que os usuários ativem a integração com a ferramenta Prisma da Mediaocean.
Ativamos o suporte para o valor de enumeração ENTITY_STATUS_PAUSED no campo entityStatus do anunciante.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.invoices Estes campos foram adicionados:
Recurso Campo(s) Anunciante AssignedTargetingOption TargetingOption Os seguintes valores de enumeração foram adicionados:
Enumeração Valores AssignedTargetingOption.Recency Exchange TargetingType Os seguintes valores de enumeração agora são válidos para os campos a seguir:
Recurso Campo Valores Anunciante entityStatus ENTITY_STATUS_PAUSED
29 de abril de 2021
Adicionamos novos campos aos recursos Canal e Lista de palavras-chave negativas que retornam a contagem de itens de linha usando o recurso para segmentação. Ativamos novas propriedades filter
para o método de lista de itens de linha, que permite ao usuário
recuperar apenas itens de linha que usam canais específicos ou listas de palavras-chave negativas
na segmentação.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) Canal Os seguintes métodos de lista agora podem ser filtrados pelas propriedades a seguir:
Método Campo(s) advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 de março de 2021
Adicionamos um novo método ao serviço de item de linha que gera um item de linha com configurações padrão. Esses valores padrão são baseados no tipo de item de linha especificado, bem como nas configurações e na segmentação atribuída do pedido de inserção principal.
Ativamos a recuperação da segmentação de campanhas usando um novo serviço de segmentação de campanhas e um método de lista em massa adicional.
A segmentação por app foi expandida para permitir a segmentação de apps em mais plataformas.
Fizemos várias mudanças nos serviços advertisers.channels.sites, partners.channels.sites e advertisers.negativeKeywordLists.negativeKeywords para facilitar o gerenciamento do conteúdo de canais e listas de palavras-chave negativas. Essas mudanças incluem:
- A adição de métodos
replace, que permite que um usuário substitua completamente o conteúdo atual de um canal ou de uma lista de palavras-chave negativas. - A remoção da exigência de que nenhum item
existente seja incluído nos campos
createdSitesoucreatedNegativeKeywordsdas solicitações de edição em massa. - O aumento do número máximo de itens que podem ser retornados em uma única página de uma resposta list sites ou list negative keywords.
Novos recursos
Os seguintes métodos foram adicionados:
Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails O tamanho máximo da página foi aumentado para os seguintes métodos de lista:
Método Tamanho máximo da página antigo Novo tamanho máximo da página advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Suspensões de uso
Os seguintes valores de enumeração não podem mais ser atribuídos a recursos novos ou atuais:
Enumeração Valores PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 de fevereiro de 2021
Introduzimos um novo serviço de segmentação de pedido de veiculação e um método de lista em massa adicional que permite recuperar a segmentação atribuída aos pedidos de veiculação. Expandimos o recurso de criativo, adicionando campos de criativo somente para saída para uso por criativos de áudio de terceiros. Adicionamos novos tipos de meta de performance para uso por recursos de pedido de inserção e campanha.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Estes campos foram adicionados:
Recurso Campo(s) Criativo Os seguintes valores de enumeração foram adicionados:
Enumeração Valores ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 de janeiro de 2021
Ativamos a recuperação e o gerenciamento de pedidos de inserção de TV e itens de linha over-the-top com a introdução de um novo campo InsertionOrderType e um novo valor de enumeração LineItemType. Foi adicionado suporte a itens de linha de apps para dispositivos móveis usando um campo de item de linha mobileApp.
Suporte expandido para exchange, google audience e SDF com valores de enumeração adicionais. Introduzimos a capacidade de filtrar e ordenar valores de advertisers.list pelo horário da última atualização.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) InsertionOrder LineItem Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Exchange GoogleAudienceType LineItemType SdfVersion Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos campos abaixo:
Método Campo(s) anunciantes
4 de dezembro de 2020
Adicionamos a capacidade de pesquisar opções de segmentação por região geográfica e filtrar vários resultados do método de lista de recursos pelo horário da última atualização. Foi introduzido um novo LineItemWarningMessage para informar aos usuários quando um item de linha está usando a segmentação geográfica descontinuada.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos targetingTypes.targetingOptions Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Exchange LineItemWarningMessage Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos campos abaixo:
Método Campo(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 de novembro de 2020
Adicionamos a capacidade de criar, atribuir e ativar acionadores manuais que iniciam o gasto dos itens de linha associados. Introduzimos opções de expansão de segmentação que, quando definidas, podem ampliar a segmentação de um item de linha para incluir usuários semelhantes aos dos públicos-alvo segmentados. Adicionamos campos de ID de segmento personalizado aos objetos DoubleVerify e Integral Ad Science usados na segmentação por verificação de terceiros.
Novos recursos
Os seguintes serviços foram adicionados:
Serviço Métodos advertisers.manualTriggers Estes campos foram adicionados:
Recurso Campo(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Os seguintes valores de enumeração foram adicionados:
Enumeração Valores LineItemFlightDateType Os seguintes métodos de lista agora podem ser filtrados pelos campos abaixo:
Método Campo(s) advertisers.lineItems.list
12 de outubro de 2020
Introduzimos mensagens de aviso recuperáveis no recurso item de linha e um tipo de meta de performance de taxa de cliques (CTR). Adicionamos 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 há uma nova documentação sobre como usar solicitações em lote.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) LineItem Os seguintes valores de enumeração foram adicionados:
Enumeração Valores PerformanceGoalType Os seguintes métodos de lista agora podem ser filtrados pelos campos abaixo:
Método Campo(s) advertisers.lineItems.list
28 de agosto de 2020
Adição de novos campos à resposta do método de auditoria do anunciante e novos campos filtráveis a vários métodos de lista.
Novos recursos
Estes campos foram adicionados:
Recurso Campo(s) Advertisers.Audit Response Body Os seguintes métodos de lista agora podem ser filtrados pelos campos abaixo:
Método Campo(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 de agosto de 2020
Lançamos novos serviços de gerenciamento de usuários, parceiros e segmentação por parceiros. Introduzimos ferramentas para ajudar os usuários a evitar proativamente o alcance dos limites de entidades da conta. Adicionamos suporte para itens de linha de áudio e o uso de algoritmos de lances personalizados em itens de linha e estratégias de lances de pedido de inserção.
Novos recursos
Os seguintes serviços foram adicionados:
Serviço Métodos customBiddingAlgorithms parceiros partners.targetingTypes.assignedTargetingOptions usuários Os seguintes métodos foram adicionados:
Serviço Métodos anunciantes Estes campos foram adicionados:
Recurso Campo(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy Os seguintes valores de enumeração foram adicionados:
Enumeração Valores BiddingStrategyPerformanceGoalType LineItemType Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos campos abaixo:
Método Campo(s) advertisers.lineItems.list Os seguintes escopos foram adicionados para uso nos serviços abaixo:
Escopo Serviço(s) https://www.googleapis.com/auth/display-video-user-management
24 de junho de 2020
Lançamos uma pequena atualização que adiciona um método de criação para canais de parceiro e anunciante, novos campos FirstAndThirdPartyAudience e valores de enumeração exchange adicionais.
Novos recursos
Os seguintes serviços foram adicionados:
Serviço Métodos advertisers.channels partners.channels Estes campos foram adicionados:
Recurso Campo(s) FirstAndThirdPartyAudience Os seguintes valores de enumeração foram adicionados:
Enumeração Valores Exchange Os seguintes métodos de lista agora podem ser filtrados pelos campos abaixo:
Método Campo(s) advertisers.creatives.list
2 de junho de 2020
Introduzimos a capacidade de criar, corrigir e preencher um subconjunto de entidades segmentáveis e adicionamos 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
Os seguintes serviços foram adicionados:
Os seguintes métodos foram adicionados:
Serviço Métodos anunciantes advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Estes campos foram adicionados:
Recurso Campo(s) advertiser creative insertionOrder.insertionOrderBudgetSegment
27 de abril de 2020
Lançamos um grande conjunto de atributos, expandindo o escopo da API além do SDF. Adicionamos o 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 editar a segmentação no nível do item de linha.
Novos recursos
Os seguintes serviços foram adicionados:
9 de março de 2020
Lançamento da API Display & Video 360 v1. Esta é a versão inicial da API.
Problemas conhecidos
Nenhum.