Notas da versão

Esta página mostra as notas da versão da API Display & Video 360.

Versão mais recente da API: v3

4 de dezembro de 2024

Novos recursos

Adição de suporte aos valores Exchange do Core e do Tubi.

Aumento do 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
  Exchange	EXCHANGE_CORE EXCHANGE_TUBI

• O 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.list	5000

22 de outubro de 2024

Novos recursos

Adição de suporte à meta de desempenho de custo por visualização.

Foi adicionada a capacidade de definir e recuperar a segmentação de dispositivos conectados.

Foram adicionadas novas configurações de brand safety da Adloox em Segmentação de verificador de terceiros.

Adicionado suporte para download de arquivos de dados estruturados v8, que está atualmente na versão Beta fechada.

v3

• Os seguintes campos foram adicionados:

  Objeto

  Campo(s)

  Adloox

  adultExplicitSexualContent armsAmmunitionContent crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent deathInjuryMilitaryConflictContent debatedSensitiveSocialIssueContent displayIabViewability excludedFraudIvtMfaCategories hateSpeechActsAggressionContent illegalDrugsTobaccoEcigarettesVapingAlcoholContent misinformationContent obscenityProfanityContent onlinePiracyContent spamHarmfulContent terrorismContent videoIabViewability

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  DeviceType	DEVICE_TYPE_CONNECTED_DEVICE
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CPV
  SdfVersion	SDF_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
  SdfVersion	SDF_VERSION_5_5

15 de agosto de 2024

Novos recursos

Inclusão de suporte para o tipo Exchange da Netflix.

v3

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Exchange	EXCHANGE_NETFLIX

v2

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Exchange	EXCHANGE_NETFLIX

15 de julho de 2024

Novos recursos

Adicionamos suporte para fazer o download de arquivos de dados estruturados de itens de linha e grupos de anúncios no formato de QA na v3.

v3

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  IdFilter	adGroupQaIds lineItemQaIds

• 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.

Foi adicionado um novo campo optimizationObjective ao recurso de pedido de inserção. O optimizationObjective está disponível apenas para clientes da lista de permissões.

v3

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  InsertionOrder	optimizationObjective

• Os métodos a seguir agora oferecem suporte aos 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 oferecem suporte aos 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

Adicionado suporte para arquivos de dados estruturados (SDF) versão 7.1.

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, trocas e plataformas de apps.

v3

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  KPI	kpiAlgorithmId

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  AppPlatform	APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV
  Exchange	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
  Exchange	EXCHANGE_DRAX
  YoutubeAndPartnersBiddingStrategyType	YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

28 de fevereiro de 2024

Novos recursos

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

Adição de suporte à segmentação de novas exchanges.

v3

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Exchange	EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID

v2

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  firstAndThirdPartyAudiences.editCustomerMatchMembers	removedContactInfoList removedMobileDeviceIdList

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Exchange	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 para informar 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 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:

  Recurso	Campo(s)
  Usuário	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

v2

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  floodlightGroups.floodlightActivities	get list

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  Usuário	lastLoginTime
  YoutubeAndPartnersInventorySourceConfig	includeGoogleTv

14 de novembro de 2023

Novos recursos

Foi adicionado suporte para transmitir o consentimento do usuário final ao fazer upload de membros do público-alvo da segmentação por correspondência do cliente em todas as versões ativas.

v3

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  ContactInfoList	consentimento
  MobileDeviceIdList	consentimento

v2

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  ContactInfoList	consentimento
  MobileDeviceIdList	consentimento

31 de outubro de 2023

Novos recursos

A v3 saiu da versão Beta pública e passou a estar disponível para todos os usuários.

O valor de tipo enumerado AdGroupFormat foi renomeado na v3 para refletir com mais precisão o formato relevante.

Inclusão de suporte para arquivos de dados estruturados v7 com a adição do valor de tipo enumerado SDF_VERSION_7 nas versões v2 e v3.

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 alterações:

• A capacidade de gerenciar totalmente listas de locais de proximidade, permitindo o uso do serviço advertisers.locationLists.assignedLocations para criar e excluir locais atribuídos aos recursos TARGETING_LOCATION_TYPE_PROXIMITY LocationList.
• 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 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.

Adição de 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	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 list
  advertisers.youtubeAdGroups	bulkListAdGroupAssignedTargetingOptions get list
  advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions	get list

• O comportamento do método a seguir mudou:

  Método	Mudança(s)
  advertisers.locationLists.create	Agora é possível criar recursos LocationList TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.patch	Agora é possível atualizar recursos LocationList TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.assignedLocations.bulkEdit	Agora é possível editar em massa os recursos AssignedLocation em recursos LocationList TARGETING_LOCATION_TYPE_PROXIMITY.
  advertisers.locationLists.assignedLocations.create	Agora é possível criar recursos AssignedLocation em recursos LocationList TARGETING_LOCATION_TYPE_PROXIMITY.

• Os seguintes parâmetros de consulta foram adicionados:

  Método	Parâmetro(s)
  inventorySources.get	advertiserId

• Os campos a seguir foram definidos como obrigatórios:

  Recurso	Campo(s)
  Anunciante	billingConfig

• Os seguintes campos foram adicionados:

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

• 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 exchanges 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

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  YoutubeAndPartnersSettings	effectiveContentCategory

• Os seguintes campos foram removidos:

  Recurso	Campo(s)
  InventorySource	subSitePropertyId

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Exchange	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 na v1 e v2.

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

Foi adicionado 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

Foi adicionada a capacidade de recuperar recursos YouTubeAdGroup e YouTubeAdGroupAd, além da segmentação de recursos de grupos 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.

Adição de suporte a quatro exchanges adicionais nas versões 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 enumeração foram adicionados:

  Enumeração	Valores
  Exchange	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
  Exchange	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 passou a estar disponível para todos os usuários.

Um novo campo assignedTargetingOptionIdAlias foi adicionado ao recurso AssignedTargetingOption, que pode ser usado no lugar do 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 que são atribuídas por tipo enumerado. O valor do alias é o valor do tipo enumerado relevante como uma string.

Um novo campo billingConfig foi adicionado ao recurso Advertiser.

Adição de suporte para a recuperação de itens de linha do YouTube e parceiros, identificados por três novos valores de LineItemType.

O tamanho máximo da página foi aumentado para 200 para vários métodos list nas versões v1 e v2. O tamanho da página padrão não é alterado.

v2

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  Anunciante	billingConfig
  AssignedTargetingOption	assignedTargetingOptionIdAlias

• 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:

  Método	Novo tamanho máximo da 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 da 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 que são atribuídas usando valores de enumeração na v2 não podiam ser removidas ou recuperadas usando o assignedTargetingOptionId e, em vez disso, esperavam que os usuários usassem o valor de enumeração. 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, retornando 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 InsertionOrder pai.

Foi introduzido o suporte à 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 delete
  advertisers.lineItems	duplicado

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:

• 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 editar e extrair a segmentação atribuída em vários itens de linha com uma somente 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ções de segmentação recuperados usando o serviço targetingTypes.targetingOptions.

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

Adição de suporte a três novas exchanges 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 bulkListAssignedTargetingOptions bulkUpdate

• Os seguintes métodos foram removidos da v2:

  Serviço	Métodos
  advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions

• Os seguintes métodos foram renomeados na v2:

  Serviço	Nome do método antigo	Nome do novo método
  advertisers	bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions	editAssignedTargetingOptions listAssignedTargetingOptions
  advertisers.campaigns	bulkListCampaignAssignedTargetingOptions	listAssignedTargetingOptions
  advertisers.insertionOrders	bulkListInsertionOrderAssignedTargetingOptions	listAssignedTargetingOptions
  parceiros	bulkEditPartnerAssignedTargetingOptions	editAssignedTargetingOptions

• Os recursos AssignedTargetingOption dos seguintes tipos de segmentação usam tipos enumerados para 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 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	Exchange
  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:

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

• Os seguintes campos foram removidos da v2:

  Recurso	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 definidos como obrigatórios na v2:

  Recurso	Campo(s)
  AgeRangeAssignedTargetingOptionDetails	ageRange
  ContentInstreamPositionAssignedTargetingOptionDetails	contentInstreamPosition
  ContentOutstreamPositionAssignedTargetingOptionDetails	contentOutstreamPosition
  DeviceTypeAssignedTargetingOptionDetails	deviceType
  DigitalContentLabelAssignedTargetingOptionDetails	excludedContentRatingTier
  EnvironmentAssignedTargetingOptionDetails	ambiente
  ExchangeAssignedTargetingOptionDetails	troca
  GenderAssignedTargetingOptionDetails	gênero
  HouseholdIncomeAssignedTargetingOptionDetails	householdIncome
  NativeContentPositionAssignedTargetingOptionDetails	contentPosition
  OmidAssignedTargetingOptionDetails	omid
  ParentalStatusAssignedTargetingOptionDetails	parentalStatus
  SensitiveCategoryAssignedTargetingOptionDetails	excludedSensitiveCategory
  VideoPlayerSizeAssignedTargetingOptionDetails	videoPlayerSize
  ViewabilityAssignedTargetingOptionDetails	viewability (em inglês)

• Os seguintes valores de tipo enumerado foram adicionados à 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
  Exchange	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:

  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 tipo enumerado foram adicionados à v1:

  Enumeração	Valores
  Exchange	EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR

26 de maio de 2022

Foi adicionada a capacidade de criar recursos InventorySource e gerenciar recursos GuaranteedOrder usando novos métodos de gravação de 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.

A nova funcionalidade do parâmetro de consulta filter foi ativada para o método advertisers.creatives.list, que permite que o usuário extraia apenas 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	create editGuaranteedOrderReadAccessors get list patch
  inventorySources	create editInventorySourceReadWriteAccessors patch

• Os seguintes campos foram adicionados:

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

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  SdfVersion	SDF_VERSION_5_5

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

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

31 de março de 2022

Foi adicionado suporte para recuperar e definir a segmentação em duração do conteúdo, tipo de transmissão e gênero.

Adicionamos o campo billableOutcome ao objeto InsertionOrder.

O campo raiseBidForDeals foi introduzido no objeto MaximizeSpendBidStrategy, permitindo que os usuários definam se a estratégia de lances aplica o preço mínimo do anunciante para as transações segmentadas.

Novos recursos

• Os seguintes campos foram adicionados:

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

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  TargetingType	TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_STREAM_TYPE

2 de fevereiro de 2022

Inclusão de suporte para criar, atualizar e editar membros de alguns recursos do recurso FirstAndThirdPartyAudience do recurso "Correspondência de clientes". A página Upload Customer Match Audiences no nosso novo guia Usar públicos-alvo detalha como usar esses novos recursos.

Um novo campo reservationType foi introduzido 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 extrair 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 duplicados.

Novos recursos

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  firstAndThirdPartyAudiences	create editCustomerMatchMembers patch

• Os seguintes campos foram adicionados:

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

9 de dezembro de 2020 .

Inclusão de 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:

  Recurso	Campo(s)
  AssignedTargetingOption	audioContentTypeDetails
  TargetingOption	audioContentTypeDetails

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  TargetingType	TARGETING_TYPE_AUDIO_CONTENT_TYPE

8 de novembro de 2021

Adicionamos suporte total para gerenciar algoritmos de lances personalizados e os scripts deles. Isso inclui:

• Funções para criar novas e atualizar customBiddingAlgorithms existentes.
• A capacidade de fazer upload de scripts pelo processo de recuperar um local de recurso disponível e, em seguida, 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 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.

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	create patch uploadScript
  customBiddingAlgorithms.scripts	create get list
  media	upload

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  SdfVersion	SDF_VERSION_5_4

14 de setembro de 2021

Inclusão do suporte à segmentação por proximidade nos tipos de segmentação TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI.

Foi adicionada a capacidade de pesquisar opções de segmentação disponíveis de TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI usando targetingTypes.targetingOptions.search, já que elas não podem ser recuperadas pelos métodos targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Foram introduzidos novos campos sharedAdvertiserIds e customBiddingAlgorithmState no recurso de algoritmo de lances personalizados e foi adicionado suporte ao tipo de algoritmo de lances personalizados GOAL_BUILDER_BASED.

Adicionamos dois novos valores ao tipo enumerado Exchange.

Novos recursos

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  AssignedTargetingOption	businessChainDetails poiDetails
  CustomBiddingAlgorithm	customBiddingAlgorithmState sharedAdvertiserIds
  TargetingOption	businessChainDetails poiDetails
  Corpo da solicitação TargetingOptions.search	businessChainSearchTerms poiSearchTerms

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  CustomBiddingAlgorithmType	GOAL_BUILDER_BASED
  Exchange	EXCHANGE_RED_FOR_PUBLISHERS EXCHANGE_TAPJOY
  TargetingType	TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_POI

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

  Método	Campo(s)
  customBiddingAlgorithms.list	customBiddingAlgorithmState

4 de agosto de 2021

Adicionamos 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 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

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  AssignedTargetingOption	omidDetails
  TargetingOption	omidDetails

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	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 da página
  advertisers.campaigns.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.lineItems.targetingTypes.assignedTargetingOptions.list	5000
  advertisers.targetingTypes.assignedTargetingOptions.list	5000

26 de maio de 2021

Lançou o 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 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.

Um novo campo prismaEnabled foi introduzido 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:

  Recurso	Campo(s)
  Anunciante	prismaEnabled
  AssignedTargetingOption	nativeContentPositionDetails
  Campanha	campaignBudgets
  TargetingOption	nativeContentPositionDetails

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	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:

  Recurso	Campo	Valores
  Anunciante	entityStatus	ENTITY_STATUS_PAUSED

29 de abril de 2021

Foram adicionados 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. Foram ativadas novas propriedades filter para o método de lista de itens de linha que permitem que o usuário extraia 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:

  Recurso	Campo(s)
  Canal	negativelyTargetedLineItemCount positivelyTargetedLineItemCount
  NegativeKeywordList	targetedLineItemCount

• 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

Um novo método foi adicionado 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 fornecido, bem como nas configurações e na segmentação atribuída do pedido de inserção pai.

A recuperação da segmentação da campanha foi ativada com um novo serviço de segmentação de campanha 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 do canal e da lista de palavras-chave negativas. Essas mudanças incluem:

• Adição de métodos replace, que permitem que um usuário substitua completamente o conteúdo 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 createdSites ou createdNegativeKeywords de 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:

  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:

  Recurso	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 anterior	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 tipo enumerado não podem mais ser atribuídos a recursos novos ou existentes:

  Enumeração	Valores
  PartnerRevenueModelMarkupType	PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

24 de fevereiro de 2021

Lançamos um novo serviço de segmentação de pedidos de inserção e um método de lista em massa adicional, permitindo a recuperação da segmentação atribuída aos pedidos de inserção. Ampliamos o recurso do criativo, adicionando campos de criativo somente para saída para uso por criativos em áudio de terceiros. Foram adicionados novos tipos de meta de performance para uso nos 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 list

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  Criativo	mp3Audio oggAudio

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	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

A recuperação e o gerenciamento de pedidos de inserção de TV e itens de linha OTT foram ativados 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 por um campo de item de linha mobileApp. Adicionado suporte à troca, público-alvo do Google e SDF com valores de tipo enumerado adicionais. Foi introduzido o recurso para filtrar e ordenar os valores de advertisers.list pela última vez de atualização.

Novos recursos

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  InsertionOrder	insertionOrderType
  LineItem	mobileApp

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	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 métodos de lista a seguir agora podem ser ordenados e filtrados pelos seguintes campos:

  Método	Campo(s)
  anunciantes	updateTime

4 de dezembro de 2020

Foi adicionado o recurso de pesquisar opções de segmentação Região geográfica e filtrar vários resultados do método de lista de recursos pela última vez de atualização. Lançamos uma nova LineItemWarningMessage para informar os 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	pesquisa

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Troca	EXCHANGE_SUPERSHIP
  LineItemWarningMessage	TARGETING_DEPRECATED_GEO_TARGET

• Os métodos de lista a seguir 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 de criar, atribuir e ativar acionadores manuais que iniciam o gasto dos itens de linha associados. Foram introduzidas 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. Campos de ID de segmento personalizado anexados 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	activate criar desativar get list patch

• Os seguintes campos foram adicionados:

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

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  LineItemFlightDateType	LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER

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

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

12 de outubro de 2020

Foram introduzidas mensagens de aviso recuperáveis no recurso do item de linha e um tipo de meta de performance de taxa de cliques (CTR). warningMessages foi adicionado como um campo filtrável ao listar itens de linha.

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

Novos recursos

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  LineItem	warningMessages

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  PerformanceGoalType	PERFORMANCE_GOAL_TYPE_CTR

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

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

28 de agosto de 2020

Novos campos foram adicionados à resposta do método de auditoria do anunciante e novos campos filtráveis foram adicionados a vários métodos de lista.

Novos recursos

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  Advertisers.Audit Response Body	adGroupCriteriaCount campaignCriteriaCount channelsCount negativeKeywordListsCount negativelyTargetedChannelsCount

• Os métodos de lista a seguir 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çamos novos serviços de gerenciamento de usuários, parceiros e segmentação de parceiros. Lançamos ferramentas para ajudar os usuários a evitar limites de entidade da conta. Inclusão de suporte a itens de linha de áudio e ao 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 list
  Parceiros	bulkEditPartnerAssignedTargetingOptions get list
  partners.targetingTypes.assignedTargetingOptions	criar excluir get list
  usuários	bulkEditAssignedUserRoles criar excluir get list patch

• Os seguintes métodos foram adicionados:

  Serviço	Métodos
  anunciantes	auditoria

• Os seguintes campos foram adicionados:

  Recurso	Campo(s)
  MaximizeSpendBidStrategy	customBiddingAlgorithmId
  PerformanceGoalBidStrategy	customBiddingAlgorithmId

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  BiddingStrategyPerformanceGoalType	BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
  LineItemType	LINE_ITEM_TYPE_AUDIO_DEFAULT

• Os métodos de lista a seguir 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çamos 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 enumeração exchange.

Novos recursos

• Os seguintes serviços foram adicionados:

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

• Os seguintes campos foram adicionados:

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

• Os seguintes valores de enumeração foram adicionados:

  Enumeração	Valores
  Troca	EXCHANGE_OPEN8 EXCHANGE_TRITON EXCHANGE_UNRULYX

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

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

2 de junho de 2020

Foi introduzida a capacidade de criar, corrigir e preencher um subconjunto de entidades segmentáveis e adicionar 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:

  Serviço	Métodos
  advertisers.channels.sites	bulkEdit criar excluir list
  advertisers.locationLists.assignedLocations	bulkEdit criar excluir list
  advertisers.negativeKeywordLists.negativeKeywords	bulkEdit criar excluir list
  advertisers.targetingTypes.assignedTargetingOptions	criar excluir get list
  inventorySourceGroups.assignedInventorySources	bulkEdit criar excluir list
  partners.channels.sites	bulkEdit criar excluir list

• 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:

  Recurso	Campo(s)
  Anunciante	servingConfig
  criativo	lineItemIds
  insertionOrder.insertionOrderBudgetSegment	campaignBudgetId

27 de abril de 2020

Lançamos um grande conjunto de recursos, expandindo o escopo da API além do SDF. Gerenciamento de recursos principais adicionado, 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:

Serviço	Métodos
anunciantes	criar excluir get list patch
advertisers.assets	fazer upload
advertisers.campaigns	criar excluir get list patch
advertisers.channels	get list
advertisers.creatives	criar excluir get list patch
advertisers.insertionOrders	criar excluir get list patch
advertisers.lineItems	bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions criar excluir get list patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions	criar excluir get list
advertisers.locationLists	get list
advertisers.negativeKeywordLists	get list
combinedAudiences	get list
customLists	get list
firstAndThirdPartyAudiences	get list
floodlightGroups	get patch
googleAudiences	get list
inventorySourceGroups	get list
inventorySources	get list
partners.channels	get list
partners.channels	get list

9 de março de 2020

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

Problemas conhecidos

Nenhum.