Nesta página, você encontra as notas da versão da API Display & Video 360.
Versão mais recente da API: v3
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:
Resource Campo(s) Kpi (em inglês) Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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 tipo enumerado foram adicionados:
Tipo enumerado 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 explicitamente os membros dos públicos-alvo segmentados por lista de clientes.
Agora é possível segmentar novas trocas.
v3
Os seguintes campos foram adicionados:
Resource Campo(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores Troca EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Os seguintes campos foram adicionados:
Resource Campo(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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
Agora é possível 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 inventário do Google TV na segmentação.
Adicionamos um novo campo para redirecionar o horário do último login de um usuário do Display & Video 360.
v3
Os seguintes métodos foram adicionados:
Serviço Métodos floodlightGroups.floodlightActivities Os seguintes campos foram adicionados:
Resource Campo(s) User YoutubeAndPartnersInventorySourceConfig
v2
Os seguintes métodos foram adicionados:
Serviço Métodos floodlightGroups.floodlightActivities Os seguintes campos foram adicionados:
Resource Campo(s) User YoutubeAndPartnersInventorySourceConfig
14 de novembro de 2023
Novos recursos
Foi adicionado suporte à transmissão do consentimento do usuário final ao fazer o upload de membros do público-alvo segmentado por lista de clientes em todas as versões ativas.
v3
Os seguintes campos foram adicionados:
Resource Campo(s) ContactInfoList MobileDeviceIdList
v2
Os seguintes campos foram adicionados:
Resource Campo(s) ContactInfoList MobileDeviceIdList
31 de outubro de 2023
Novos recursos
Removemos a v3 da versão Beta pública para a disponibilidade geral.
Um valor de enumeração AdGroupFormat
foi renomeado na v3 para refletir
com mais precisão o formato relevante.
Foi adicionado suporte para arquivos de dados estruturados v7 com a adição do
valor de enumeração SDF_VERSION_7
nas versões v2 e v3.
v3
Os seguintes valores de enumeração foram removidos:
Tipo enumerado Valores AdGroupFormat AD_GROUP_FORMAT_ACTION
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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:
- Gerenciar totalmente as listas de locais por proximidade, permitindo o uso do serviço
advertisers.locationLists.assignedLocations
para criar e excluir locais atribuídos aos recursos deTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Um novo campo booleano
enableOptimizedTargeting
, que substitui o campotargetingExpansionLevel
no objetoTargetingExpansionConfig
. - O requisito do campo
billingConfig
no recursoAdvertiser
, que precisa ser incluído ao fazer solicitações deadvertisers.create
, e um novo campobillingConfig
no recursoPartner
. - Novos recursos
AdGroup
eAdGroupAd
que substituem os recursosYoutubeAdGroup
eYoutubeAdGroupAd
na v2.
Siga as etapas no nosso guia de migração para migrar da v2 para a v3.
Foi adicionado suporte a três novos valores de LineItemType
, um novo
YoutubeAndPartnersBiddingStrategyType
e um novo
PartnerCostType
nas v2 e v3.
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
lista
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
lista
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
lista
O comportamento do método a seguir mudou:
Método Alterações advertisers.locationLists.create Agora oferece suporte para a criação de TARGETING_LOCATION_TYPE_PROXIMITY
recursosLocationList
.advertisers.locationLists.patch Agora oferece suporte à atualização de TARGETING_LOCATION_TYPE_PROXIMITY
recursosLocationList
.advertisers.locationLists.assignedLocations.bulkEdit Agora oferece suporte à edição em massa dos recursos AssignedLocation
em recursosTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.create Agora oferece suporte à criação de recursos AssignedLocation
em recursosTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.Os seguintes parâmetros de consulta foram adicionados:
Método Parâmetros inventorySources.get Os seguintes campos agora são obrigatórios:
Resource Campo(s) Anunciante Os seguintes campos foram adicionados:
Resource Campo(s) BiddingStrategy InsertionOrder kpi (em inglês)
Parceiro TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Os seguintes campos foram removidos:
Resource Campo(s) InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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:
Tipo enumerado Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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
Agora é possível usar duas trocas e dois novos tipos de estratégias de lances do YouTube e parceiros.
Adicionamos um novo campo effectiveContentCategory
aos itens de linha do YouTube &
Partners para exibir o
YoutubeAndPartnersContentCategory
usado pelo item de linha ao
considerar os valores atribuídos no nível do anunciante e do item de linha.
v2
Os seguintes campos foram adicionados:
Resource Campo(s) YoutubeAndPartnersSettings Os seguintes campos foram removidos:
Resource Campo(s) InventorySource subSitePropertyId
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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
Foi adicionado um novo valor de SdfVersion
para arquivos de dados estruturados
(SDF, na sigla em inglês) v6 nas versões v1 e v2.
v2
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores SdfVersion SDF_VERSION_6
v1
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores SdfVersion SDF_VERSION_6
9 de março de 2023
Novos recursos
Foi adicionado um novo valor LineItemWarningMessage
que será
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 definido como false
após 25 de março de 2023.
v2
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 de fevereiro de 2023
Novos recursos
Adicionamos a capacidade de recuperar recursos de 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.
Agora é possível usar mais quatro trocas na v1 e v2.
v2
Os seguintes métodos foram adicionados:
Serviço Métodos advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Os seguintes campos foram adicionados:
Serviço Métodos AssignedTargetingOption YoutubeAndPartnersSettings Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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 tipo enumerado foram adicionados:
Tipo enumerado Valores Troca EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 de dezembro de 2022
Novos recursos
Removemos a v2 da versão Beta pública para a disponibilidade geral.
Foi adicionado um novo campo assignedTargetingOptionIdAlias
ao
recurso AssignedTargetingOption
, que pode ser usado no lugar de
assignedTargetingOptionId
ao recuperar e excluir a segmentação.
Este campo é definido apenas para opções de segmentação atribuídas de tipos de segmentação
atribuídos via tipo enumerado. O valor de alias é o valor de tipo enumerado relevante como uma string.
Adicionamos um novo campo billingConfig
ao
recurso Advertiser
.
Foi adicionado suporte para a recuperação de itens de linha over-the-top do YouTube e parceiros,
identificados por três novos valores de LineItemType
.
Aumento do tamanho máximo da página para 200 em vários métodos list
na v1 e v2. O
tamanho da página padrão se mantém inalterado.
v2
Os seguintes campos foram adicionados:
Resource Campo(s) Anunciante AssignedTargetingOption Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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 aumentou para os seguintes métodos de lista:
v1
O tamanho máximo da página aumentou 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ídas usando valores
de tipo enumerado na v2 não podiam ser removidas ou recuperadas
usando
assignedTargetingOptionId
. Em vez disso, era esperado que os usuários usassem o valor de tipo enumerado. Com essa atualização, essas opções de segmentação atribuídas podem ser removidas ou recuperadas usando oassignedTargetingOptionId
ou o valor da enumeração, identificado pelo novo campoassignedTargetingOptionIdAlias
no recursoAssignedTargetingOption
. - A solicitação do item de linha
bulkUpdate
não estava usando 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 deadvertisersId
paraadvertiserId
.
27 de outubro de 2022
Agora é possível duplicar um item de linha no InsertionOrder
pai.
Introduzimos suporte à gravação da segmentação de pedido de inserção parcial 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 recurso novo foi adicionado à v1.
20 de setembro de 2022
Lançamento da v2 na versão Beta pública, que inclui as seguintes mudanças:
- Recuperar itens de linha do YouTube e parceiros e as configurações de segmentação usando os métodos
get
elist
nos serviçosadvertisers.lineItems
eadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Dois novos métodos de segmentação em massa no serviço
advertisers.lineItems
que permitem editar e recuperar a segmentação atribuída em vários itens de linha com uma única solicitação. - Um novo método
bulkUpdate
que permite aos usuários atualizar aentityStatus
de vários itens de linha em uma única solicitação. - Nova lógica de segmentação que exige que recursos
AssignedTargetingOption
de um subconjunto de tipos de segmentação sejam atribuídos e recuperados usando valores de tipo enumerado em vez de IDs de opções de segmentação recuperados usando o serviçotargetingTypes.targetingOptions
.
Siga as etapas no nosso guia de migração para migrar da v1 para a v2.
Adicionamos suporte para três novas trocas na v1.
Novos recursos
v2
Veja a seguir uma lista das alterações entre as versões v1 e v2:
Os métodos a seguir 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 métodos a seguir foram renomeados na v2:
Serviço Antigo nome do método Nome do novo método advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Os recursos do
AssignedTargetingOption
dos seguintes tipos de segmentação usam tipos enumerados para atribuição de segmentação na v2. O campoassignedTargetingOptionId
para recursosAssignedTargetingOption
desses tipos de segmentação também foi atualizado na v2 para usar versões de string dos valores de tipo enumerado: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 (link em inglês) 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 campos a seguir foram removidos na v2:
Os seguintes campos passaram a ser obrigatórios na v2:
Os seguintes valores de tipo enumerado foram adicionados na v2:
Tipo enumerado 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 tipo enumerado foram removidos na v2:
Tipo enumerado 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 tipo enumerado foram adicionados à v1:
Tipo enumerado Valores Troca EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 de maio de 2022
Foi adicionada a capacidade de criar recursos InventorySource
e
gerenciar recursos GuaranteedOrder
usando os novos métodos de gravação do serviço
inventorySources
e um novo serviço
guaranteedOrders
.
O campo modelReadiness
foi introduzido no recurso
CustomBiddingAlgorithm
. Esse campo lista a prontidão do modelo do algoritmo para cada anunciante que pode acessá-lo.
Ativação da nova funcionalidade de parâmetro de consulta filter
para
o método advertisers.creatives.list
, que permite ao usuário
recuperar criativos com um updateTime
antes ou depois de um determinado carimbo de data/hora.
Foi adicionado suporte à versão mais recente do SDF, v5.5, com a
adição de um valor de enumeração SdfVersion
.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos guaranteedOrders inventorySources Os seguintes campos foram adicionados:
Resource Campo(s) CustomBiddingAlgorithm InventorySource Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores SdfVersion Os métodos de lista a seguir agora podem ser filtrados pelas seguintes propriedades:
Método Campo(s) advertisers.creatives.list
31 de março de 2022
Foi adicionado suporte à recuperação e configuração da segmentação na duração do conteúdo, no tipo de stream e no gênero.
Adicionamos o campo billableOutcome
ao objeto
InsertionOrder
.
O campo raiseBidForDeals
foi introduzido ao
objeto MaximizeSpendBidStrategy
, permitindo que os usuários definam se a estratégia de
lances aplica os preços mínimos do anunciante para as transações segmentadas.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores TargetingType
2 de fevereiro de 2022
Agora é possível criar, atualizar e editar membros de determinados recursos FirstAndThirdPartyAudience
da Segmentação por lista de clientes. A página Fazer o upload de públicos-alvo segmentados por lista de clientes no novo guia Usar públicos-alvo mostra como utilizar esses novos recursos.
Foi introduzido um novo campo reservationType
nos recursos
InsertionOrder
e LineItem
que identifica se um recurso é de tag garantida, programática
garantida ou não garantido.
Foi adicionada a capacidade de recuperar e definir se um item de linha segmenta automaticamente
novas trocas por meio de 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 Os seguintes campos foram adicionados:
Resource Campo(s) FirstAndThirdPartyAudience InsertionOrder LineItem
9 de dezembro de 2020 .
Foi adicionado suporte à segmentação por conteúdo de áudio no tipo de segmentação
TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption TargetingOption Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores TargetingType
8 de novembro de 2021
Suporte completo para gerenciar algoritmos de lances personalizados e os scripts deles. Isso inclui:
- Funções para criar novas funções e atualizar existentes
customBiddingAlgorithms
. - A capacidade de fazer upload de scripts pelo processo de extração de um local de recurso disponível e upload do arquivo para esse local.
- Um novo serviço
customBiddingAlgorithms.scripts
para recuperar e criarcustomBiddingScripts
.
Adicionamos uma nova página Implementar lances personalizados no guia Como gerenciar itens de linha. Ela descreve o processo de criação de um algoritmo de lances personalizados, upload de um script e atribuição desse algoritmo como a estratégia de lances de um item de linha.
Foi adicionado suporte à versão mais recente do SDF, v5.4, com a
adiçã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 tipo enumerado foram adicionados:
Tipo enumerado Valores SdfVersion
14 de setembro de 2021
Foi adicionado suporte à área de segmentação por proximidade nos tipos TARGETING_TYPE_BUSINESS_CHAIN
e TARGETING_TYPE_POI
.
Foi adicionada a capacidade de pesquisar as opções de segmentação
TARGETING_TYPE_BUSINESS_CHAIN
e
TARGETING_TYPE_POI
disponíveis usando
targetingTypes.targetingOptions.search
, já que elas não podem ser
recuperadas pelos métodos targetingTypes.targetingOptions.get
ou
targetingTypes.targetingOptions.list
.
Adição dos novos campos sharedAdvertiserIds
e
customBiddingAlgorithmState
ao recurso de algoritmo de lances personalizados
e suporte ao tipo de algoritmo de lances personalizados
GOAL_BUILDER_BASED
.
Foram adicionados dois novos valores ao tipo enumerado Exchange
.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Corpo da solicitação TargetOptions.search Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores CustomBiddingAlgorithmType Troca TargetingType Os métodos de lista a seguir agora podem ser filtrados pelas seguintes propriedades:
Método Campo(s) customBiddingAlgorithms.list
4 de agosto de 2021
Foi adicionado suporte à segmentação de inventário
ativada para o Open Measurement 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 métodos de lista de opções de segmentação de anunciantes, campanhas, pedidos de inserção e itens de linha usando o parâmetro pageSize
.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption TargetingOption Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores TargetingType O tamanho máximo da página aumentou para os seguintes métodos de lista:
26 de maio de 2021
Lançamento do serviço advertisers.invoices
, que permite
que os usuários:
- recuperar faturas emitidas para um anunciante durante um determinado mês.
- pesquisar o código de moeda usado por um anunciante durante um determinado mês.
Adicionamos o campo campaignBudgets
ao recurso da campanha. Os segmentos de orçamento do pedido de inserção podem ser vinculados a um orçamento da campanha, restringindo o orçamento total dos segmentos associados ao valor total do orçamento da campanha.
Foi adicionado suporte à
segmentação por posição de conteúdo nativo no novo
tipo de segmentação TARGETING_TYPE_NATIVE_CONTENT_POSITION
.
Introdução de um novo campo prismaEnabled
ao recurso do
anunciante, permitindo que os usuários ativem a integração com a ferramenta Prisma do Mediaocean.
Ativação do 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 Os seguintes campos foram adicionados:
Resource Campo(s) Anunciante AssignedTargetingOption TargetingOption Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores AssignedTargetingOption.Recency Troca TargetingType Os valores de tipo enumerado a seguir agora são válidos para os seguintes campos:
Resource Field Valores Anunciante entityStatus ENTITY_STATUS_PAUSED
29 de abril de 2021
Adição de novos campos aos recursos de Canal e
Lista de palavras-chave negativas que retornam a contagem de itens de linha
que usam o recurso para segmentação. Ativamos as novas propriedades filter
para o método de lista de itens de linha que permitem ao usuário
recuperar apenas itens de linha que usam canais específicos ou listas de palavras-chave
negativas na segmentação.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) Canal Os métodos de lista a seguir agora podem ser filtrados pelas seguintes propriedades:
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 as configurações padrão. Esses valores padrão são baseados no tipo de item de linha informado, bem como nas configurações e na segmentação atribuída do pedido de inserção pai.
Ativação da recuperação da segmentação da campanha por meio de um novo serviço de segmentação de campanhas e outro método de lista em massa.
A segmentação de apps 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 da lista de palavras-chave negativas e do canal. Essas
mudanças incluem:
- A adição de métodos
replace
, que permite que um usuário substitua totalmente o conteúdo existente de uma lista de canais ou palavras-chave negativas. - Remoção do requisito de que nenhum item
existente seja incluído nos campos
createdSites
oucreatedNegativeKeywords
das 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 de listar sites ou listar palavras-chave negativas.
Novos recursos
Os seguintes métodos foram adicionados:
Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails O tamanho máximo da página aumentou 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
Descontinuações
Os seguintes valores de tipo enumerado não podem mais ser atribuídos a recursos novos ou atuais:
Tipo enumerado Valores PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 de fevereiro de 2021
Introdução de um novo serviço de segmentação de pedidos de inserção e outro método de lista em massa, que permite a recuperação da segmentação atribuída a pedidos de inserção. Ampliamos o recurso do criativo, adicionando campos de criativos somente de saída para uso por criativos em áudio de terceiros. Adicionamos novos tipos de meta de desempenho 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 Os seguintes campos foram adicionados:
Resource Campo(s) Criativo Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado 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 InsertOrderType e
novo valor de enumeração LineItemType. Foi adicionado suporte a itens de linha de apps para dispositivos móveis
por meio de um campo de item de linha mobileApp
.
Compatibilidade com troca, público-alvo do Google e SDF expandidos com outros valores de tipo enumerado. Foi introduzido o
recurso de filtrar e ordenar os valores de advertisers.list
pelo horário da última atualização.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) InsertionOrder LineItem Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores Troca GoogleAudienceType LineItemType SdfVersion Os métodos de lista a seguir agora podem ser ordenados e filtrados pelos seguintes campos:
Método Campo(s) anunciantes
4 de dezembro de 2020
Foi adicionado o recurso para pesquisar as opções de segmentação de região geográfica e filtrar vários resultados do método da lista de recursos pelo horário da última atualização. Introdução de um novo LineItemWarningMessage para informar aos usuários quando um item de linha estiver usando uma segmentação geográfica descontinuada.
Novos recursos
Os seguintes métodos foram adicionados:
Serviço Métodos targetingTypes.targetingOptions Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores Troca LineItemWarningMessage Os métodos de lista a seguir agora podem ser ordenados e filtrados pelos seguintes campos:
Método Campo(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 de novembro de 2020
Foi adicionado o recurso de criar, atribuir e ativar acionadores manuais que iniciam os gastos dos itens de linha associados. Introdução das opções de expansão de segmentação que, quando definidas, podem expandir a segmentação de um item de linha para incluir usuários semelhantes aos dos públicos-alvo segmentados. Os campos de ID do segmento personalizados foram anexados 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 Os seguintes campos foram adicionados:
Resource Campo(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores LineItemFlightDateType Os métodos de lista a seguir agora podem ser filtrados pelos seguintes campos:
Método Campo(s) advertisers.lineItems.list
12 de outubro de 2020
Introdução de mensagens de aviso recuperáveis ao recurso
de item de linha e um tipo de meta de desempenho de taxa de cliques (CTR). warningMessages
foi adicionado como um campo filtrável ao listar itens de linha.
Além dos novos recursos, novos limites de cota agora estão em vigor, e uma nova documentação sobre a utilização de solicitações em lote está disponível.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) LineItem Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores PerformanceGoalType Os métodos de lista a seguir agora podem ser filtrados pelos seguintes campos:
Método Campo(s) advertisers.lineItems.list
28 de agosto de 2020
Adicionamos novos campos à resposta do método de auditoria do anunciante e novos campos filtráveis a vários métodos de lista.
Novos recursos
Os seguintes campos foram adicionados:
Resource Campo(s) Corpo de resposta da auditoria sobre anunciantes Os métodos de lista a seguir agora podem ser filtrados pelos seguintes campos:
Método Campo(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 de agosto de 2020
Lançamento de novos serviços de gerenciamento de usuários, parceiros e parceiros de segmentação. Introdução de ferramentas para ajudar os usuários a evitar proativamente atingir os limites de entidades da conta. Agora é possível usar itens de linha de áudio e usar algoritmos de lances personalizados nas estratégias de lances de itens de linha e 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 Os seguintes campos foram adicionados:
Resource Campo(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores BiddingStrategyPerformanceGoalType LineItemType Os métodos de lista a seguir agora podem ser ordenados e filtrados pelos seguintes campos:
Método Campo(s) advertisers.lineItems.list Os seguintes escopos foram adicionados para uso nos seguintes serviços:
Escopo Serviço(s) https://www.googleapis.com/auth/display-video-user-management
24 de junho de 2020
Lançamento de uma pequena atualização que adiciona um método de criação para canais de parceiros e anunciante, novos campos FirstAndThirdPartyAudience e outros valores de tipo enumerado de troca.
Novos recursos
Os seguintes serviços foram adicionados:
Serviço Métodos advertisers.channels partners.channels Os seguintes campos foram adicionados:
Resource Campo(s) FirstAndThirdPartyAudience Os seguintes valores de tipo enumerado foram adicionados:
Tipo enumerado Valores Troca Os métodos de lista a seguir agora podem ser filtrados pelos seguintes campos:
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. Além disso, adicionamos a capacidade de modificar a segmentação no nível do anunciante para três tipos de segmentação: canal, exclusão de rótulo 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 Os seguintes campos foram adicionados:
Resource Campo(s) anunciante criativo insertionOrder.insertionOrderBudgetSegment
27 de abril de 2020
Lançamos um grande conjunto de recursos, ampliando o escopo da API para além do SDF. Adicionado 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 a edição da 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. Essa é a versão inicial da API.
Problemas conhecidos
Nenhum.