Notas da versão

Esta página contém notas da versão da API Display & Video 360.

Versão mais recente da API: v3

17 de junho de 2024

Novos recursos

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

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

v3

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  InsertionOrder	optimizationObjective

• Os métodos a seguir agora são compatíveis com os seguintes tipos de segmentação:

  Tipo de segmentação	Métodos
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

v2

• Os métodos a seguir agora são compatíveis com os seguintes tipos de segmentação:

  Tipo de segmentação	Métodos
  TARGETING_TYPE_KEYWORD	advertisers.editAssignedTargetingOptions advertisers.listAssignedTargetingOptions advertisers.targetingType.assignedTargetingOptions.create advertisers.targetingType.assignedTargetingOptions.delete advertisers.targetingType.assignedTargetingOptions.get advertisers.targetingType.assignedTargetingOptions.list

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:

  Tipo enumerado	Valores
  SdfVersion	SDF_VERSION_7_1

v2

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  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:

  Resource	Campo(s)
  KPIs	kpiAlgorithmId

• 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 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	removedContactInfoList removedMobileDeviceIdList

• 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	removedContactInfoList removedMobileDeviceIdList

• 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

Foi adicionada a capacidade de recuperar atividades do Floodlight por meio de um novo serviço floodlightGroups.floodlightActivities.

Adicionamos um novo campo para informar se um item de linha do YouTube & Partners 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	get list

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  floodlightGroups.floodlightActivities	get list

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  User	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 de novembro de 2023

Novos recursos

Agora é possível transmitir o consentimento do usuário final durante 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	consentimento
  MobileDeviceIdList	consentimento

v2

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  ContactInfoList	consentimento
  MobileDeviceIdList	consentimento

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 refletir com mais precisão o formato relevante

Foi adicionado suporte aos 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 tipo enumerado 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

A v3 foi lançada 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 a recursos LocationList do TARGETING_LOCATION_TYPE_PROXIMITY.
• Um novo campo booleano enableOptimizedTargeting, que substitui o campo targetingExpansionLevel no objeto TargetingExpansionConfig.
• O requisito do campo billingConfig no recurso Advertiser, que precisa ser incluído ao fazer solicitações de advertisers.create, e um novo campo billingConfig no recurso Partner.
• Novos recursos AdGroup e AdGroupAd que substituem os recursos YoutubeAdGroup e YoutubeAdGroupAd na v2.

Siga as etapas do 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 versões v2 e v3.

v3

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  advertisers.adGroupAds	get list
  advertisers.adGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.adGroups.targetingTypes.assignedTargetingOptions	get list
  customBiddingAlgorithms	uploadRules
  customBiddingAlgorithms.rules	create get list

• 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 à criação de recursos LocationList do TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.patch	Agora oferece suporte à atualização de recursos LocationList do TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.assignedLocations.bulkEdit	Agora é possível editar em massa os recursos AssignedLocation nos recursos TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
  advertisers.locationLists.assignedLocations.create	Agora oferece suporte à criação de recursos AssignedLocation em recursos LocationList do TARGETING_LOCATION_TYPE_PROXIMITY.

• Os seguintes parâmetros de consulta foram adicionados:

  Método	Parâmetros
  inventorySources.get	advertiserId

• Os seguintes campos agora são obrigatórios:

  Resource	Campo(s)
  Anunciante	billingConfig

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  BiddingStrategy	youtubeAndPartnersBid
  InsertionOrder	KPIs
  Parceiro	billingConfig
  TargetingExpansionConfig	audienceExpansionLevel audienceExpansionSeedListExcluded enableOptimizedTargeting
  YoutubeAndPartnersSettings	thirdPartyMeasurementConfigs
  YoutubeAndPartnersInventorySourceConfig	includeYoutube

• 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 tipo enumerado 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 fazer duas trocas 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 os valores atribuídos no nível do anunciante e do item de linha.

v2

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  YoutubeAndPartnersSettings	effectiveContentCategory

• 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

Adicionamos um novo valor SdfVersion para Arquivos de dados estruturados (SDF) v6 nas 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

Foi adicionada a capacidade de recuperar recursos YouTubeAdGroup e YouTubeAdGroupAd, bem como a segmentação de recursos do grupo de anúncios do YouTube. Além disso, também 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.

Suporte adicionado para mais quatro trocas nas v1 e v2.

v2

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  advertisers.youtubeAdGroupAds	get list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• Os seguintes campos foram adicionados:

  Serviço	Métodos
  AssignedTargetingOption	sessionPositionDetails youtubeChannelDetails youtubeVideoDetails
  YoutubeAndPartnersSettings	leadFormId linkedMerchantId relatedVideoIds targetFrequency videoAdSequenceSettings

• 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

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

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 é definido apenas para opções de segmentação atribuídas de tipos de segmentação atribuídos por meio de um 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 à 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 nas v1 e v2. O tamanho de página padrão não foi alterado.

v2

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  Anunciante	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 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 foi aumentado para os seguintes métodos de lista:

  Método	Novo tamanho máximo de página
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

v1

• O tamanho máximo da página foi aumentado para os seguintes métodos de lista:

  Método	Novo tamanho máximo de página
  advertisers.campaigns.list	200
  advertisers.channels.list	200
  advertisers.creatives.list	200
  advertisers.invoices.list	200
  advertisers.lineItems.list	200
  advertisers.list	200
  advertisers.locationLists.assignedLocations.list	200
  advertisers.locationLists.list	200
  advertisers.manualTriggers.list	200
  advertisers.negativeKeywordLists.list	200
  combinedAudiences.list	200
  customBiddingAlgorithms.list	200
  customBiddingAlgorithms.scripts.list	200
  customLists.list	200
  firstAndThirdPartyAudiences.list	200
  googleAudiences.list	200
  guaranteedOrders.list	200
  inventorySourceGroups.list	200
  inventorySources.list	200
  partners.channels.list	200
  partners.list	200
  partners.targetingTypes.assignedTargetingOptions.list	200
  targetingTypes.targetingOptions.list	200
  targetingTypes.targetingOptions.search	200
  users.list	200

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 tipo enumerado na v2 não podiam ser removidas ou recuperadas usando o assignedTargetingOptionId e, em vez disso, os usuários esperavam que usassem o valor de tipo enumerado. Com essa atualização, essas opções de segmentação atribuídas podem ser removidas ou recuperadas usando o assignedTargetingOptionId ou o valor de enumeração, identificado pelo novo campo assignedTargetingOptionIdAlias no recurso AssignedTargetingOption.
• A solicitação bulkUpdate do item de linha não estava usando corretamente o parâmetro de solicitação advertisersId, o que retornou um erro. Com essa atualização, o método foi corrigido, e o parâmetro de solicitação foi renomeado de advertisersId para advertiserId.

27 de outubro de 2022

Foi adicionada a capacidade de duplicar um item de linha existente no pai InsertionOrder.

Introdução de suporte de gravação de segmentação de ordem 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	create excluir
  advertisers.lineItems	duplicada

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:

• A capacidade de recuperar itens de linha do YouTube e parceiros e as configurações de segmentação deles usando os métodos get e list nos serviços advertisers.lineItems e advertisers.lineItems.targetingTypes.assignedTargetingOptions .
• Dois novos métodos de segmentação em massa no serviço advertisers.lineItems que permitem a edição e a recuperação da 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 o entityStatus de vários itens de linha em uma única solicitação.
• Nova lógica de segmentação que exige que os 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ção de segmentação recuperados usando o serviço targetingTypes.targetingOptions.

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:

• Os métodos a seguir foram adicionados na v2:

  Serviço	Métodos
  advertisers.lineItems	bulkEditAssignedTargetingOptions bulkListAssignedTargetingOptions bulkUpdate

• Os métodos a seguir 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	Novo nome do método
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  partners	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Os recursos AssignedTargetingOption dos tipos de segmentação abaixo usam tipos enumerados para a atribuição de segmentação na v2. O campo assignedTargetingOptionId para recursos AssignedTargetingOption 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 tipo enumerado
  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 campos a seguir foram adicionados na v2:

  Resource	Campo(s)
  CustomBiddingAlgorithm	modelDetails
  DeviceTypeAssignedTargetingOptionDetails	youtubeAndPartnersBidMultiplier
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  ExchangeAssignedTargetingOptionDetails	troca
  FrequencyCap	maxViews
  LineItem	youtubeAndPartnersSettings
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadius proximityRadiusUnit
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory

• Os campos a seguir foram removidos na v2:

  Resource	Campo(s)
  AgeRangeAssignedTargetingOptionDetails	targetingOptionId
  ContentInstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  ContentOutstreamPositionAssignedTargetingOptionDetails	targetingOptionId
  CustomBiddingAlgorithm	customBiddingAlgorithmState
  DeviceTypeAssignedTargetingOptionDetails	targetingOptionId
  DigitalContentLabelAssignedTargetingOptionDetails	contentRatingTier excludedTargetingOptionId
  EnvironmentAssignedTargetingOptionDetails	targetingOptionId
  ExchangeAssignedTargetingOptionDetails	targetingOptionId
  GenderAssignedTargetingOptionDetails	targetingOptionId
  HouseholdIncomeAssignedTargetingOptionDetails	targetingOptionId
  LineItem	inventorySourceIds
  LineItemFlight	triggerId
  NativeContentPositionAssignedTargetingOptionDetails	targetingOptionId
  OmidAssignedTargetingOptionDetails	targetingOptionId
  ParentalStatusAssignedTargetingOptionDetails	targetingOptionId
  ProximityLocationListAssignedTargetingOptionDetails	proximityRadiusRange
  SensitiveCategoryAssignedTargetingOptionDetails	excludedTargetingOptionId sensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	targetingOptionId
  ViewabilityAssignedTargetingOptionDetails	targetingOptionId

• Os campos a seguir foram obrigatórios na v2:

  Resource	Campo(s)
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	ambiente
  ExchangeAssignedTargetingOptionDetails	troca
  GenderAssignedTargetingOptionDetails	gender [gênero]
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	visibilidade

• Os seguintes valores de tipo enumerado foram adicionados à 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 de GuaranteedOrder usando 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.

Ativamos a nova funcionalidade do 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 tipo enumerado SdfVersion.

Novos recursos

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  guaranteedOrders	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  CustomBiddingAlgorithm	modelReadiness
  InventorySource	inventorySourceProductType guaranteedOrderId readAdvertiserIds readPartnerIds readWriteAccessors

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  SdfVersion	SDF_VERSION_5_5

• Os seguintes métodos de lista agora podem ser filtrados pelas seguintes propriedades:

  Método	Campo(s)
  advertisers.creatives.list	updateTime

31 de março de 2022

Foi adicionado suporte à recuperação e definição de segmentações pela duração do conteúdo, tipo de stream e 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 preços mínimos do anunciante para transações segmentadas.

Novos recursos

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  AssignedTargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails
  InsertionOrder	billableOutcome
  MaximizeSpendBidStrategy	raiseBidForDeals
  TargetingOption	contentDurationDetails contentGenreDetails contentStreamTypeDetails

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 de fevereiro de 2022

Agora é possível criar, atualizar e editar membros de determinados recursos da Segmentação por lista de clientes FirstAndThirdPartyAudience. A página Fazer upload de públicos-alvo segmentados por lista de clientes no nosso novo guia Usar públicos-alvo detalha como usar esses novos recursos.

Foi introduzido um novo campo reservationType nos recursos InsertionOrder e LineItem, que identifica se um recurso é garantido por tags ou programática garantida ou não.

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	create editCustomerMatchMembers patch

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  FirstAndThirdPartyAudience	appId contactInfoList mobileDeviceIdList
  InsertionOrder	reservationType
  LineItem	excludeNewExchanges reservationType

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

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 de novembro de 2021

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

• Funções para criar novas e atualizar customBiddingAlgorithms as existentes.
• Capacidade de fazer upload de scripts por meio do processo de recuperação de um local de recurso disponível e fazer upload do arquivo para esse local.
• Um novo serviço customBiddingAlgorithms.scripts para extrair e criar customBiddingScripts.

Adicionamos uma nova página Implementar lances personalizados ao guia Como gerenciar itens de linha, que descreve o processo de criação de um algoritmo de lances personalizados, upload de um script e a atribuição do algoritmo de lances personalizados 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 tipo enumerado SdfVersion.

Novos recursos

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  customBiddingAlgorithms	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	fazer upload

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  SdfVersion	SDF_VERSION_5_4

14 de setembro de 2021

Foi adicionado suporte à área de segmentação por proximidade nos tipos de segmentação 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 por métodos targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Adicionamos novos campos sharedAdvertiserIds e customBiddingAlgorithmState ao recurso "Algoritmo de lances personalizados" e adicionamos 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	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Segmento da solicitação.search	businessChainSearchTerms poiSearchTerms

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Troca	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

• Os seguintes métodos de lista agora podem ser filtrados pelas seguintes propriedades:

  Método	Campo(s)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 de agosto de 2021

Foi adicionado suporte à segmentação de inventário ativada pelo 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 da lista de opções de segmentação atribuída de anunciante, campanha, pedido de inserção e item de linha usando o parâmetro do método pageSize.

Novos recursos

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  TargetingType	TARGETING_TYPE_OMID

• O tamanho máximo da página foi aumentado para os seguintes métodos de lista:

  Método	Novo tamanho máximo de página
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5.000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5.000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5.000
  advertisers.targetingTypes.assignedTargetingOptions.list	5.000

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 da 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 de 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.

Um novo campo prismaEnabled foi incluído no recurso do anunciante, permitindo que os usuários ativem a integração com a ferramenta Prisma da Mediaocean.

Ativação do suporte ao valor de enumeração ENTITY_STATUS_PAUSED para o campo entityStatus do anunciante.

Novos recursos

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  advertisers.invoices	list lookupInvoiceCurrency

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  Anunciante	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Campaign	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  AssignedTargetingOption.Recency	RECENCY_45_DAYS
  Troca	EXCHANGE_MEDIANET
  TargetingType	TARGETING_TYPE_NATIVE_CONTENT_POSITION

• Os seguintes valores de tipo enumerado agora são válidos para os seguintes campos:

  Resource	Field	Valores
  Anunciante	entityStatus	ENTITY_STATUS_PAUSED

29 de abril de 2021

Adicionamos novos campos aos recursos de 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 somente 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	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• Os seguintes métodos de lista 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 fornecido, bem como nas configurações e na segmentação atribuída do pedido de inserção pai.

Ativou a 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.

Foram feitas 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 de canais. Essas mudanças incluem:

• Adição de métodos replace, que permite ao usuário substituir completamente o conteúdo existente de um canal ou de uma lista de palavras-chave negativas.
• Remoção do requisito de que nenhum item atual seja incluído nos campos createdSites ou createdNegativeKeywords das solicitações de edição em massa.
• 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:

  Serviço	Métodos
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions
  advertisers.campaigns.targetingTypes.assignedTargetingOptions	get list
  advertisers.channels.sites	replace
  advertisers.lineItems	generateDefault
  advertisers.negativeKeywordLists.negativeKeywords	replace
  partners.channels.sites	replace

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  AssignedTargetingOption.AppAssignedTargetingOptionDetails	appPlatform

• 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 de 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 pedido 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 do criativo somente para saída para uso em 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	bulkListInsertionOrderAssignedTargetingOptions
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions	get (em inglês) list (link em inglês)

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  Criativo	mp3Audio oggAudio

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  ContentInstreamPosition	CONTENT_INSTREAM_POSITION_UNKNOWN
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_CLICK_CVR PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR PERFORMANCE_GOAL_TYPE_VCPM PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE PERFORMANCE_GOAL_TYPE_VTR

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 um novo valor de enumeração OrderType. Foi adicionado suporte a itens de linha de apps para dispositivos móveis por um campo de item de linha mobileApp. Suporte expandido para trocas, públicos-alvo do Google e SDF usando outros valores de tipo enumerado. Foi introduzida a capacidade 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	insertionOrderType
  LineItem	mobileApp

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  Troca	EXCHANGE_SHARETHROUGH EXCHANGE_SOUNDCAST
  GoogleAudienceType	GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC GOOGLE_AUDIENCE_TYPE_LIFE_EVENT
  LineItemType	LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP
  SdfVersion	SDF_VERSION_5_3

• Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos seguintes campos:

  Método	Campo(s)
  anunciantes	updateTime

4 de dezembro de 2020

Inclusão da capacidade de pesquisar opções de segmentação por região geográfica e filtrar vários resultados de métodos da lista de recursos pelo horário da última atualização. Introdução de um novo itemWarningMessage para informar aos usuários quando um item de linha está usando segmentação geográfica descontinuada.

Novos recursos

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  targetingTypes.targetingOptions	pesquisar

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  Troca	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.campaigns.list	updateTime
  advertisers.insertionOrders.list	updateTime
  advertisers.lineItems.list	updateTime

5 de novembro de 2020

Foi adicionado o recurso para criar, atribuir e ativar acionadores manuais que iniciam os gastos dos itens de linha associados. Introdução de 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 àqueles nos públicos-alvo segmentados. Anexos de campos de ID de segmento personalizados aos objetos DoubleVerify e Integral Ad Science usados na segmentação de verificação de terceiros.

Novos recursos

• Os seguintes serviços foram adicionados:

  Serviço	Métodos
  advertisers.manualTriggers	ativar criar desativar get (em inglês) list (link em inglês) patch

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  AssignedTargetingOption.DoubleVerify	customSegmentId
  AssignedTargetingOption.IntegralAdScience	customSegmentId
  LineItem	targetingExpansion
  LineItemFlight	triggerId

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

• Os seguintes métodos de lista agora podem ser filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.lineItems.list	filter.triggerId

12 de outubro de 2020

Mensagens de aviso recuperáveis foram introduzidas ao recurso de item de linha e um tipo de meta de desempenho de taxa de cliques (CTR). Adição de warningMessages como um campo filtrável na listagem de itens de linha.

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

Novos recursos

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  LineItem	warningMessages

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

• Os seguintes métodos de lista agora podem ser filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.lineItems.list	warningMessages

28 de agosto de 2020

Adicionados 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 da resposta de anunciantes.Audit	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Os seguintes métodos de lista agora podem ser filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.list	advertiserId displayName
  advertisers.campaigns.list	campaignId displayName
  advertisers.insertionOrders.list	budget.budget_segments.date_range.end_date displayName
  advertisers.lineItems.list	displayName lineItemId
  targetingTypes.targetingOptions.list	carrierAndIspDetails.type geoRegionDetails.geo_region_type

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

• Os seguintes serviços foram adicionados:

  Serviço	Métodos
  customBiddingAlgorithms	get (em inglês) list (link em inglês)
  parceiros	bulkEditPartnerAssignedTargetingOptions get (em inglês) list (link em inglês)
  partners.targetingTypes.assignedTargetingOptions	criar excluir get (em inglês) list (link em inglês)
  usuários	bulkEditAssignedUserRoles criar excluir get (em inglês) list (link em inglês) patch

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  anunciantes	auditar

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Os seguintes métodos de lista agora podem ser ordenados e filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.lineItems.list	flight.dateRange.endDate

• Os seguintes escopos foram adicionados para uso nos seguintes serviços:

  Escopo	Serviço(s)
  https://www.googleapis.com/auth/display-video-user-management	usuários

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

• Os seguintes serviços foram adicionados:

  Serviço	Métodos
  advertisers.channels	criar
  partners.channels	criar

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  FirstAndThirdPartyAudience	activeDisplayAudienceSize audienceSource audienceType descrição displayAudienceSize displayDesktopAudienceSize displayMobileAppAudienceSize displayMobileWebAudienceSize gmailAudienceSize membershipDurationDays youtubeAudienceSize

• Os seguintes valores de tipo enumerado foram adicionados:

  Tipo enumerado	Valores
  Troca	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

• Os seguintes métodos de lista agora podem ser filtrados pelos seguintes campos:

  Método	Campo(s)
  advertisers.creatives.list	creativeId

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

• Os seguintes serviços foram adicionados:

  Serviço	Métodos
  advertisers.channels.sites	bulkEdit criar excluir list (link em inglês)
  advertisers.locationLists.assignedLocations	bulkEdit criar excluir list (link em inglês)
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit criar excluir list (link em inglês)
  advertisers.targetingTypes.assignedTargetingOptions	criar excluir get (em inglês) list (link em inglês)
  inventorySourceGroups.assignedInventorySources	bulkEdit criar excluir list (link em inglês)
  partners.channels.sites	bulkEdit criar excluir list (link em inglês)

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  anunciantes	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions
  advertisers.channels	patch
  advertisers.locationLists	criar patch
  advertisers.negativeKeywordLists	criar excluir patch
  inventorySourceGroups	criar excluir patch
  partners.channels	patch

• Os seguintes campos foram adicionados:

  Resource	Campo(s)
  anunciante	servingConfig
  criativo	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 de abril de 2020

Um grande conjunto de recursos foi lançado, expandindo o escopo da API para além dos SDFs. Adição do 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ço	Métodos
anunciantes	criar excluir get (em inglês) list (link em inglês) patch
advertisers.assets	fazer upload
advertisers.campaigns	criar excluir get (em inglês) list (link em inglês) patch
advertisers.channels	get (em inglês) list (link em inglês)
advertisers.creatives	criar excluir get (em inglês) list (link em inglês) patch
advertisers.insertionOrders	criar excluir get (em inglês) list (link em inglês) patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions criar excluir get (em inglês) list (link em inglês) patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	criar excluir get (em inglês) list (link em inglês)
advertisers.locationLists	get (em inglês) list (link em inglês)
advertisers.negativeKeywordLists	get (em inglês) list (link em inglês)
combinedAudiences	get (em inglês) list (link em inglês)
customLists	get (em inglês) list (link em inglês)
firstAndThirdPartyAudiences	get (em inglês) list (link em inglês)
floodlightGroups	get (em inglês) patch
googleAudiences	get (em inglês) list (link em inglês)
inventorySourceGroups	get (em inglês) list (link em inglês)
inventorySources	get (em inglês) list (link em inglês)
partners.channels	get (em inglês) list (link em inglês)
partners.channels	get (em inglês) list (link em inglês)

9 de março de 2020

Lançamento da API Display & Video 360 v1. Esta é a versão inicial da API.

Problemas conhecidos

Nenhum.