Cette page fournit les notes de version des versions abandonnées de l'API Display & Video 360.
Accédez à la page principale des notes de version pour toutes les versions disponibles.
4 décembre 2024
Nouvelles fonctionnalités
Ajout de la compatibilité avec les valeurs Exchange Core et Tubi.
La taille de page maximale autorisée pour firstAndThirdPartyAudiences.list est passée de 200 à 5000. Mettez à jour le paramètre pageSize de vos requêtes firstAndThirdPartyAudiences.list pour optimiser davantage l'utilisation de votre quota.
v3
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) ExchangeEXCHANGE_COREEXCHANGE_TUBILa taille maximale des pages a été augmentée pour les méthodes de liste suivantes :
Méthode Nouvelle taille de page maximale firstAndThirdPartyAudiences.list5000
22 octobre 2024
Nouvelles fonctionnalités
Ajout de la prise en charge de l'objectif de performances "Coût par vue".
Ajout de la possibilité de définir et de récupérer le ciblage des appareils connectés.
Ajout de nouveaux paramètres de brand safety Adloox sous ciblage par vérificateur tiers.
Ajout de la possibilité de télécharger des fichiers de données structurées v8, actuellement en version bêta fermée.
v3
Les champs suivants ont été ajoutés :
Objet Champ(s) AdlooxcrimeHarmfulActsIndividualsSocietyHumanRightsViolationsContentdeathInjuryMilitaryConflictContentdebatedSensitiveSocialIssueContenthateSpeechActsAggressionContentLes valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) DeviceTypeDEVICE_TYPE_CONNECTED_DEVICEPerformanceGoalTypePERFORMANCE_GOAL_TYPE_CPVSdfVersionSDF_VERSION_8
Valeurs obsolètes
Suppression de la compatibilité avec le format SDF 5.5, qui sera abandonné le 3 octobre 2024.
v3
Les valeurs d'énumération suivantes sont obsolètes :
Énumération Valeur(s) SdfVersionSDF_VERSION_5_5
15 août 2024
Nouvelles fonctionnalités
Ajout de la compatibilité avec le type Netflix Exchange.
v3
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_NETFLIX
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_NETFLIX
15 juillet 2024
Nouvelles fonctionnalités
Ajout de la possibilité de télécharger des fichiers de données structurées d'éléments de campagne et de groupes d'annonces au format QA dans la version 3.
v3
Les champs suivants ont été ajoutés :
Ressource Champ(s) IdFilter Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
17 juin 2024
Nouvelles fonctionnalités
Ajout de la possibilité de gérer le ciblage par mots clés attribué au niveau de l'annonceur.
Ajout du nouveau champ optimizationObjective à la ressource d'ordre d'insertion. optimizationObjective n'est disponible que pour les clients figurant sur la liste d'autorisation.
v3
Les champs suivants ont été ajoutés :
Ressource Champ(s) InsertionOrder Les méthodes suivantes sont désormais compatibles avec les types de ciblage suivants :
Type de ciblage Méthode(s) TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Les méthodes suivantes sont désormais compatibles avec les types de ciblage suivants :
Type de ciblage Méthode(s) TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 mai 2024
Nouvelles fonctionnalités
Ajout de la compatibilité avec la version 7.1 des fichiers de données structurées (SDF).
v3
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion SDF_VERSION_7_1
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion SDF_VERSION_7_1
23 avril 2024
Nouvelles fonctionnalités
Ajout de la compatibilité avec de nouveaux types de KPI, de nouvelles plates-formes d'échange et de nouvelles plates-formes d'applications.
v3
Les champs suivants ont été ajoutés :
Ressource Champ(s) KPI Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Place de marché 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
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Place de marché EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 février 2024
Nouvelles fonctionnalités
Ajout de la possibilité de supprimer explicitement des membres des audiences de ciblage par liste de clients.
Ajout de la compatibilité avec le ciblage de nouvelles places de marché.
v3
Les champs suivants ont été ajoutés :
Ressource Champ(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Les champs suivants ont été ajoutés :
Ressource Champ(s) firstAndThirdPartyAudiences.editCustomerMatchMembers Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
29 janvier 2024
Nouvelles fonctionnalités
Ajout de la possibilité de récupérer des activités Floodlight via un nouveau service floodlightGroups.floodlightActivities.
Ajout d'un champ indiquant si un élément de campagne YouTube et partenaires inclut l'inventaire Google TV dans son ciblage.
Ajout d'un champ pour indiquer la dernière heure de connexion d'un utilisateur Display & Video 360.
v3
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) floodlightGroups.floodlightActivities Les champs suivants ont été ajoutés :
Ressource Champ(s) Utilisateur YoutubeAndPartnersInventorySourceConfig
v2
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) floodlightGroups.floodlightActivities Les champs suivants ont été ajoutés :
Ressource Champ(s) Utilisateur YoutubeAndPartnersInventorySourceConfig
14 novembre 2023
Nouvelles fonctionnalités
Ajout de la compatibilité avec la transmission du consentement de l'utilisateur final lors de l'importation de membres d'audience pour le ciblage des clients dans toutes les versions en ligne.
v3
Les champs suivants ont été ajoutés :
Ressource Champ(s) ContactInfoList MobileDeviceIdList
v2
Les champs suivants ont été ajoutés :
Ressource Champ(s) ContactInfoList MobileDeviceIdList
31 octobre 2023
Nouvelles fonctionnalités
La version 3 est passée de la version bêta publique à la disponibilité générale.
Renommage d'une valeur d'énumération AdGroupFormat dans la version 3 pour refléter plus précisément le format concerné.
Ajout de la compatibilité avec les fichiers de données structurées v7 grâce à l'ajout de la valeur d'énumération SDF_VERSION_7 dans les versions 2 et 3.
v3
Les valeurs d'énumération suivantes ont été supprimées :
Énumération Valeur(s) AdGroupFormat AD_GROUP_FORMAT_ACTION
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion SDF_VERSION_7
2 octobre 2023
Nouvelles fonctionnalités
Publication de la version 3 en version bêta publique, qui inclut les modifications suivantes :
- Possibilité de gérer entièrement les listes de lieux à proximité, ce qui permet d'utiliser le service
advertisers.locationLists.assignedLocationspour créer et supprimer des lieux attribués aux ressourcesTARGETING_LOCATION_TYPE_PROXIMITYLocationList. - Un nouveau champ booléen
enableOptimizedTargeting, qui remplace le champtargetingExpansionLeveldans l'objetTargetingExpansionConfig. - L'exigence du champ
billingConfigdans la ressourceAdvertiser, qui doit être inclus lors de l'envoi de requêtesadvertisers.create, et un nouveau champbillingConfigdans la ressourcePartner. - Nouvelles ressources
AdGroupetAdGroupAdqui remplacent les ressourcesYoutubeAdGroupetYoutubeAdGroupAddans la version 2.
Suivez la procédure décrite dans notre guide de migration pour migrer de la version 2 vers la version 3.
Ajout de la compatibilité avec trois nouvelles valeurs LineItemType, une nouvelle valeur YoutubeAndPartnersBiddingStrategyType et une nouvelle valeur PartnerCostType dans les versions 2 et 3.
v3
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Les méthodes suivantes ont été supprimées :
Service Méthode(s) advertisers.manualTriggers activer
create
désactiver
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Le comportement de la méthode suivante a changé :
Méthode Modification(s) advertisers.locationLists.create Il est désormais possible de créer des ressources TARGETING_LOCATION_TYPE_PROXIMITYLocationList.advertisers.locationLists.patch Il est désormais possible de mettre à jour les ressources LocationList.TARGETING_LOCATION_TYPE_PROXIMITYadvertisers.locationLists.assignedLocations.bulkEdit Il est désormais possible de modifier de manière groupée les ressources AssignedLocationdans les ressourcesLocationListTARGETING_LOCATION_TYPE_PROXIMITY.advertisers.locationLists.assignedLocations.create Il est désormais possible de créer des ressources AssignedLocationdans des ressourcesTARGETING_LOCATION_TYPE_PROXIMITYLocationList.Les paramètres de requête suivants ont été ajoutés :
Méthode Paramètre(s) inventorySources.get Les champs suivants sont désormais obligatoires :
Ressource Champ(s) Annonceur Les champs suivants ont été ajoutés :
Ressource Champ(s) BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Les champs suivants ont été supprimés :
Ressource Champ(s) InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) 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
Les valeurs d'énumération suivantes ont été supprimées :
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) 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
15 août 2023
Nouvelles fonctionnalités
Ajout de la compatibilité avec deux places de marché et deux nouveaux types de stratégies d'enchères YouTube et partenaires.
Ajout d'un champ effectiveContentCategory aux éléments de campagne YouTube et partenaires pour afficher la YoutubeAndPartnersContentCategory utilisée par l'élément de campagne lors de la prise en compte des valeurs attribuées au niveau de l'annonceur et de l'élément de campagne.
v2
Les champs suivants ont été ajoutés :
Ressource Champ(s) YoutubeAndPartnersSettings Les champs suivants ont été supprimés :
Ressource Champ(s) InventorySource subSitePropertyId
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
5 juin 2023
Nouvelles fonctionnalités
Ajout d'une nouvelle valeur SdfVersion pour les fichiers de données structurées (SDF) v6 dans les versions 1 et 2.
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion SDF_VERSION_6
v1
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion SDF_VERSION_6
9 mars 2023
Nouvelles fonctionnalités
Ajout d'une nouvelle valeur LineItemWarningMessage qui sera attribuée au champ warningMessages d'un élément de campagne si le champ excludeFirstPartyAudience obsolète est défini sur true. Le champ excludeFirstPartyAudience sera abandonné et défini sur false après le 25 mars 2023.
v2
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
8 février 2023
Nouvelles fonctionnalités
Ajout de la possibilité de récupérer les ressources YouTubeAdGroup et YouTubeAdGroupAd, ainsi que le ciblage des ressources de groupe d'annonces YouTube. Nous avons également ajouté de nouveaux types de ciblage récupérables utilisés au niveau des groupes d'annonces YouTube. Pour en savoir plus, consultez notre nouvelle page du guide sur la récupération des ressources YouTube et partenaires.
Ajout de la prise en charge de quatre places de marché supplémentaires dans les versions 1 et 2.
v2
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Les champs suivants ont été ajoutés :
Service Méthode(s) AssignedTargetingOption YoutubeAndPartnersSettings Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché 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
Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
6 décembre 2022
Nouvelles fonctionnalités
La version 2 est passée de la version bêta publique à la disponibilité générale.
Ajout d'un nouveau champ assignedTargetingOptionIdAlias à la ressource AssignedTargetingOption, qui peut être utilisé à la place de assignedTargetingOptionId lors de la récupération et de la suppression du ciblage.
Ce champ n'est défini que pour les options de ciblage attribuées de types de ciblage qui sont attribués via enum. La valeur de l'alias est la valeur enum correspondante sous forme de chaîne.
Ajout d'un champ billingConfig à la ressource Advertiser.
Ajout de la compatibilité pour récupérer les éléments de campagne YouTube et partenaires over-the-top, identifiés par trois nouvelles valeurs LineItemType.
La taille de page maximale a été augmentée à 200 pour de nombreuses méthodes list dans les versions 1 et 2. La taille de page par défaut reste inchangée.
v2
Les champs suivants ont été ajoutés :
Ressource Champ(s) Annonceur AssignedTargetingOption Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) 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
La taille maximale des pages a été augmentée pour les méthodes de liste suivantes :
v1
La taille maximale des pages a été augmentée pour les méthodes de liste suivantes :
Problèmes connus
Cette mise à jour corrige les problèmes connus suivants dans la version 2 :
- Les options de ciblage attribuées des types de ciblage attribués à l'aide de valeurs enum dans la version 2 ne pouvaient pas être supprimées ni récupérées à l'aide de leur
assignedTargetingOptionId. Les utilisateurs devaient utiliser la valeur enum. Grâce à cette mise à jour, ces options de ciblage attribuées peuvent être supprimées ou récupérées à l'aide deassignedTargetingOptionIdou de la valeur enum, identifiée par le nouveau champassignedTargetingOptionIdAliasdans la ressourceAssignedTargetingOption. - La requête
bulkUpdatepour l'élément de ligne n'utilisait pas correctement le paramètre de requêteadvertisersIdet a renvoyé une erreur. Avec cette mise à jour, la méthode a été corrigée et le paramètre de requête a été renommé deadvertisersIdàadvertiserId.
27 octobre 2022
Ajout de la possibilité de dupliquer un élément de campagne existant dans le InsertionOrder parent.
Ajout de la compatibilité avec l'écriture du ciblage partiel des ordres d'insertion pour un sous-ensemble de types de ciblage avec l'ajout des méthodes create et delete au service advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.
Nouvelles fonctionnalités
v2
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Aucune nouvelle fonctionnalité n'a été ajoutée à la version 1.
20 septembre 2022
Publication de la version 2 en bêta publique, qui inclut les modifications suivantes :
- Possibilité de récupérer les éléments de campagne YouTube et partenaires, ainsi que leurs paramètres de ciblage, à l'aide des méthodes
getetlistdans les servicesadvertisers.lineItemsetadvertisers.lineItems.targetingTypes.assignedTargetingOptions. - Deux nouvelles méthodes de ciblage groupé dans le service
advertisers.lineItemsqui permettent d'modifier et de récupérer le ciblage attribué à plusieurs éléments de campagne en une seule requête. - Une nouvelle méthode
bulkUpdatequi permet aux utilisateurs de mettre à jour leentityStatusde plusieurs éléments de campagne dans une seule requête. - Nouvelle logique de ciblage qui nécessite que les ressources
AssignedTargetingOptiond'un sous-ensemble de types de ciblage soient attribuées et récupérées à l'aide de valeurs enum au lieu d'ID d'option de ciblage récupérés à l'aide du servicetargetingTypes.targetingOptions.
Suivez la procédure décrite dans notre guide de migration pour migrer de la version 1 vers la version 2.
Ajout de la compatibilité avec trois nouvelles places de marché dans la version 1.
Nouvelles fonctionnalités
v2
Voici une liste des modifications apportées entre la version 1 et la version 2 :
Les méthodes suivantes ont été ajoutées dans la version 2 :
Service Méthode(s) advertisers.lineItems bulkEditAssignedTargetingOptions
Les méthodes suivantes ont été supprimées dans la version 2 :
Service Méthode(s) advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Les méthodes suivantes ont été renommées dans la version 2 :
Service Ancien nom de la méthode Nouveau nom de la méthode advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Les ressources
AssignedTargetingOptiondes types de ciblage suivants utilisent des énumérations pour l'attribution du ciblage dans la version 2. Le champassignedTargetingOptionIdpour les ressourcesAssignedTargetingOptionde ces types de ciblage a également été mis à jour dans la version 2 pour utiliser les versions de chaîne des valeurs d'énumération :Type de ciblage Type d'énumération 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 Environment TARGETING_TYPE_EXCHANGE Place de marché TARGETING_TYPE_GENDER Genre 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 Visibilité Les champs suivants ont été ajoutés dans la version 2 :
Les champs suivants ont été supprimés dans la version 2 :
Les champs suivants sont désormais obligatoires dans la version 2 :
Les valeurs d'énumération suivantes ont été ajoutées dans la version 2 :
Énumération Valeur(s) 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
Place de marché 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
Les valeurs d'énumération suivantes ont été supprimées dans la version 2 :
Énumération Valeur(s) 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
Les valeurs d'énumération suivantes ont été ajoutées dans la version 1 :
Énumération Valeur(s) Place de marché EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
26 mai 2022
Ajout de la possibilité de créer des ressources InventorySource et de gérer des ressources GuaranteedOrder à l'aide de nouvelles méthodes d'écriture de service inventorySources et d'un nouveau service guaranteedOrders.
Ajout du champ modelReadiness dans la ressource CustomBiddingAlgorithm. Ce champ indique l'état de préparation du modèle de l'algorithme pour chaque annonceur qui peut y accéder.
Activation de la nouvelle fonctionnalité du paramètre de requête filter pour la méthode advertisers.creatives.list, qui permet à l'utilisateur de n'extraire que les créations avec un updateTime avant ou après un code temporel donné.
Ajout de la compatibilité avec la dernière version des fichiers SDF, v5.5, grâce à l'ajout d'une valeur d'énumération SdfVersion.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) guaranteedOrders inventorySources Les champs suivants ont été ajoutés :
Ressource Champ(s) CustomBiddingAlgorithm InventorySource Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion Les méthodes de liste suivantes peuvent désormais être filtrées par les propriétés suivantes :
Méthode Champ(s) advertisers.creatives.list
31 mars 2022
Ajout de la prise en charge de la récupération et de la définition du ciblage sur la durée du contenu, le type de flux et le genre.
Ajout du champ billableOutcome à l'objet InsertionOrder.
Ajout du champ raiseBidForDeals à l'objet MaximizeSpendBidStrategy, permettant aux utilisateurs de définir si la stratégie d'enchères applique les prix plancher de l'annonceur aux accords ciblés.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) TargetingType
2 février 2022
Ajout de la prise en charge de la création, de la mise à jour et de la modification des membres de certaines ressources FirstAndThirdPartyAudience de ciblage par liste de clients. La page Importer des audiences de ciblage par liste de clients de notre nouveau guide Utiliser les audiences explique en détail comment utiliser ces nouvelles fonctionnalités.
Ajout d'un champ reservationType dans les ressources InsertionOrder et LineItem pour indiquer si une ressource est garantie par tag, garantie programmatique ou non garantie.
Ajout de la possibilité de récupérer et de définir si un élément de campagne cible automatiquement de nouvelles places de marché grâce à un nouveau champ excludeNewExchanges.
En plus des nouvelles fonctionnalités, les limites de quota par défaut ont été doublées.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) firstAndThirdPartyAudiences Les champs suivants ont été ajoutés :
Ressource Champ(s) FirstAndThirdPartyAudience InsertionOrder LineItem
8 décembre 2021
Ajout de la prise en charge du ciblage par type de contenu audio sous le type de ciblage TARGETING_TYPE_AUDIO_CONTENT_TYPE.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) TargetingType
8 novembre 2021
Ajout de la prise en charge complète de la gestion des algorithmes d'enchères personnalisées et de leurs scripts. Par exemple :
- Fonctions permettant de créer et de mettre à jour des
customBiddingAlgorithms. - Possibilité d'importer des scripts en récupérant l'emplacement d'une ressource disponible, puis en important le fichier à cet emplacement.
- Un nouveau service
customBiddingAlgorithms.scriptspour récupérer et créercustomBiddingScripts.
Une nouvelle page Implémenter les enchères personnalisées a été ajoutée à notre guide Gérer les éléments de campagne. Elle décrit le processus de création d'un algorithme d'enchères personnalisées, d'importation d'un script et d'attribution de l'algorithme d'enchères personnalisées en tant que stratégie d'enchères d'un élément de campagne.
Ajout de la compatibilité avec la dernière version des fichiers SDF, v5.4, grâce à l'ajout d'une valeur d'énumération SdfVersion.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) customBiddingAlgorithms customBiddingAlgorithms.scripts media Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) SdfVersion
14 septembre 2021
Ajout de la compatibilité avec le ciblage de proximité dans les types de ciblage
TARGETING_TYPE_BUSINESS_CHAIN et
TARGETING_TYPE_POI.
Ajout de la possibilité de rechercher les options de ciblage TARGETING_TYPE_BUSINESS_CHAIN et TARGETING_TYPE_POI disponibles à l'aide de targetingTypes.targetingOptions.search, car elles ne peuvent pas être récupérées à l'aide des méthodes targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.
Ajout des champs sharedAdvertiserIds et customBiddingAlgorithmState à la ressource Custom Bidding Algorithm et ajout de la compatibilité avec le type d'algorithme d'enchères personnalisées GOAL_BUILDER_BASED.
Ajout de deux nouvelles valeurs à l'énumération Exchange.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Corps de la requête TargetingOptions.search Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) CustomBiddingAlgorithmType Place de marché TargetingType Les méthodes de liste suivantes peuvent désormais être filtrées par les propriétés suivantes :
Méthode Champ(s) customBiddingAlgorithms.list
4 août 2021
Ajout de la compatibilité avec le ciblage de l'inventaire compatible avec Open Measurement sous le type de ciblage TARGETING_TYPE_OMID.
Le nombre maximal d'options de ciblage attribuées pouvant être renvoyées sur une seule page de différentes méthodes de liste d'options de ciblage attribuées annonceur, campagne, ordre d'insertion et élément de campagne a été augmenté à l'aide du paramètre de méthode pageSize.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) TargetingType La taille maximale des pages a été augmentée pour les méthodes de liste suivantes :
26 mai 2021
Lancement du service advertisers.invoices, qui permet aux utilisateurs :
- récupérer les factures émises à un annonceur au cours d'un mois donné.
- rechercher le code de devise utilisé par un annonceur au cours d'un mois donné.
Ajout du champ campaignBudgets à la ressource de campagne. Les segments de budget d'ordre d'insertion peuvent être associés à un budget de campagne, ce qui limite la somme des budgets des segments associés au montant total du budget de la campagne.
Ajout de la compatibilité avec le ciblage natif de la position du contenu sous le nouveau type de ciblage TARGETING_TYPE_NATIVE_CONTENT_POSITION.
Ajout d'un champ prismaEnabled à la ressource "annonceur", permettant aux utilisateurs d'activer l'intégration à l'outil Prisma de Mediaocean.
Ajout de la valeur d'énumération ENTITY_STATUS_PAUSED au champ entityStatus de l'annonceur.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) advertisers.invoices Les champs suivants ont été ajoutés :
Ressource Champ(s) Annonceur AssignedTargetingOption TargetingOption Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) AssignedTargetingOption.Recency Place de marché TargetingType Les valeurs d'énumération suivantes sont désormais valides pour les champs suivants :
Ressource Champ Valeur(s) Annonceur entityStatus ENTITY_STATUS_PAUSED
29 avril 2021
Ajout de nouveaux champs aux ressources Channel et Negative Keyword List qui renvoient le nombre d'articles utilisant la ressource pour le ciblage. Activation de nouvelles propriétés filter pour la méthode list des éléments de campagne, qui permettent à l'utilisateur de récupérer uniquement les éléments de campagne qui utilisent des listes de canaux ou de mots clés à exclure spécifiques dans leur ciblage.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) Canal Les méthodes de liste suivantes peuvent désormais être filtrées par les propriétés suivantes :
Méthode Champ(s) advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
30 mars 2021
Ajout d'une nouvelle méthode au service d'article qui génère un article avec des configurations par défaut. Ces valeurs par défaut sont basées sur le type d'élément de campagne donné, ainsi que sur les paramètres et le ciblage attribués de l'ordre d'insertion parent.
Activation de la récupération du ciblage de campagne via un nouveau service de ciblage de campagne et une méthode de liste groupée supplémentaire.
Élargissement du ciblage d'applications pour permettre le ciblage d'applications sur plus de plates-formes.
Nous avons apporté plusieurs modifications aux services advertisers.channels.sites, partners.channels.sites et advertisers.negativeKeywordLists.negativeKeywords pour faciliter la gestion du contenu des listes de chaînes et de mots clés à exclure. Voici quelques exemples de modifications :
- Ajout de méthodes
replace, qui permettent à un utilisateur de remplacer complètement le contenu existant d'une liste de chaînes ou de mots clés à exclure. - Suppression de l'exigence selon laquelle aucun élément existant ne doit être inclus dans les champs
createdSitesoucreatedNegativeKeywordsdes demandes de modification groupée. - Augmentation du nombre maximal d'éléments pouvant être renvoyés sur une seule page d'une réponse list sites ou list negative keywords.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption.AppAssignedTargetingOptionDetails La taille maximale des pages a été augmentée pour les méthodes de liste suivantes :
Méthode Ancienne taille de page maximale Nouvelle taille de page maximale advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Abandons
Les valeurs d'énumération suivantes ne peuvent plus être attribuées à des ressources nouvelles ou existantes :
Énumération Valeur(s) PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
24 février 2021
Nous avons lancé un nouveau service de ciblage des ordres d'insertion et une méthode de liste groupée supplémentaire permettant de récupérer le ciblage attribué aux ordres d'insertion. Développement de la ressource de création, avec ajout de champs de création en sortie uniquement pour les créations audio tierces. Ajout de nouveaux types d'objectifs de performances à utiliser par les ressources ordre d'insertion et campagne.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Les champs suivants ont été ajoutés :
Ressource Champ(s) Création Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
27 janvier 2021
Permet de récupérer et de gérer les ordres d'insertion TV et les éléments de campagne OTT grâce à l'introduction d'un nouveau champ InsertionOrderType et d'une nouvelle valeur d'énumération LineItemType. Ajout de la prise en charge des éléments de campagne pour applications mobiles via un champ d'élément de campagne mobileApp.
Prise en charge étendue des places de marché, des audiences Google et des SDF grâce à des valeurs d'énumération supplémentaires. Ajout de la possibilité de filtrer et d'ordonner les valeurs advertisers.list par heure de la dernière mise à jour.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) InsertionOrder LineItem Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché GoogleAudienceType LineItemType SdfVersion Les méthodes de liste suivantes peuvent désormais être triées et filtrées par les champs suivants :
Méthode Champ(s) annonceurs
4 décembre 2020
Ajout de la possibilité d'rechercher les options de ciblage Région géographique et de filtrer les résultats de la méthode list pour plusieurs ressources en fonction de leur dernière date de mise à jour. Ajout d'un nouveau LineItemWarningMessage pour informer les utilisateurs lorsqu'un élément de campagne utilise un ciblage géographique obsolète.
Nouvelles fonctionnalités
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) targetingTypes.targetingOptions Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché LineItemWarningMessage Les méthodes de liste suivantes peuvent désormais être triées et filtrées par les champs suivants :
Méthode Champ(s) advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
5 novembre 2020
Ajout de la possibilité de créer, d'attribuer et d'activer des déclencheurs manuels qui lancent les dépenses des éléments de campagne associés. Nous avons introduit des options d'élargissement du ciblage qui, lorsqu'elles sont définies, peuvent élargir le ciblage d'un élément de campagne pour inclure les utilisateurs similaires à ceux des audiences ciblées. Ajout de champs d'ID de segment personnalisé aux objets DoubleVerify et Integral Ad Science utilisés dans le ciblage de la validation tierce.
Nouvelles fonctionnalités
Les services suivants ont été ajoutés :
Service Méthode(s) advertisers.manualTriggers Les champs suivants ont été ajoutés :
Ressource Champ(s) AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) LineItemFlightDateType Les méthodes de liste suivantes peuvent désormais être filtrées par les champs suivants :
Méthode Champ(s) advertisers.lineItems.list
12 octobre 2020
Ajout de messages d'avertissement récupérables à la ressource d'élément de campagne et d'un type d'objectif de performances de taux de clics (CTR). Ajout de warningMessages en tant que champ filtrable lors de la liste des éléments de campagne.
En plus des nouvelles fonctionnalités, de nouvelles limites de quota sont désormais en vigueur et une nouvelle documentation sur l'utilisation des requêtes par lot est disponible.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) LineItem Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) PerformanceGoalType Les méthodes de liste suivantes peuvent désormais être filtrées par les champs suivants :
Méthode Champ(s) advertisers.lineItems.list
28 août 2020
Ajout de champs à la réponse de la méthode d'audit des annonceurs et de nouveaux champs filtrables à différentes méthodes de liste.
Nouvelles fonctionnalités
Les champs suivants ont été ajoutés :
Ressource Champ(s) Corps de la réponse Advertisers.Audit Les méthodes de liste suivantes peuvent désormais être filtrées par les champs suivants :
Méthode Champ(s) advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
4 août 2020
Lancement de nouveaux services de gestion des utilisateurs, des partenaires et de ciblage des partenaires. Nous avons introduit des outils pour aider les utilisateurs à éviter de manière proactive d'atteindre les limites d'entités de compte. Ajout de la compatibilité avec les éléments de campagne audio et l'utilisation d'algorithmes d'enchères personnalisées dans les stratégies d'enchères des éléments de campagne et des ordres d'insertion.
Nouvelles fonctionnalités
Les services suivants ont été ajoutés :
Service Méthode(s) customBiddingAlgorithms partners partners.targetingTypes.assignedTargetingOptions users Les méthodes suivantes ont été ajoutées :
Service Méthode(s) annonceurs Les champs suivants ont été ajoutés :
Ressource Champ(s) MaximizeSpendBidStrategy PerformanceGoalBidStrategy Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) BiddingStrategyPerformanceGoalType LineItemType Les méthodes de liste suivantes peuvent désormais être triées et filtrées par les champs suivants :
Méthode Champ(s) advertisers.lineItems.list Les champs d'application suivants ont été ajoutés pour les services suivants :
Champ d'application Service(s) https://www.googleapis.com/auth/display-video-user-management
24 juin 2020
Petite mise à jour ajoutant une méthode de création pour les canaux partner et advertiser, de nouveaux champs FirstAndThirdPartyAudience et des valeurs d'énumération exchange supplémentaires.
Nouvelles fonctionnalités
Les services suivants ont été ajoutés :
Service Méthode(s) advertisers.channels partners.channels Les champs suivants ont été ajoutés :
Ressource Champ(s) FirstAndThirdPartyAudience Les valeurs enum suivantes ont été ajoutées :
Énumération Valeur(s) Place de marché Les méthodes de liste suivantes peuvent désormais être filtrées par les champs suivants :
Méthode Champ(s) advertisers.creatives.list
2 juin 2020
Nous avons ajouté la possibilité de créer, de corriger et de remplir un sous-ensemble d'entités ciblables, ainsi que de modifier le ciblage au niveau de l'annonceur pour trois types de ciblage : canal, exclusion de libellé de contenu numérique et exclusion de catégorie sensible.
Nouvelles fonctionnalités
Les services suivants ont été ajoutés :
Les méthodes suivantes ont été ajoutées :
Service Méthode(s) annonceurs advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Les champs suivants ont été ajoutés :
Ressource Champ(s) annonceur creative insertionOrder.insertionOrderBudgetSegment
27 avril 2020
Lancement d'un large ensemble de fonctionnalités, étendant la portée de l'API au-delà du SDF. Ajout de la gestion des ressources principales, qui vous permet de créer, récupérer, mettre à jour et supprimer des entités telles que des annonceurs, des campagnes, des ordres d'insertion, des éléments de campagne et des créations. De nouvelles fonctionnalités permettent également de modifier le ciblage au niveau des éléments de campagne.
Nouvelles fonctionnalités
Les services suivants ont été ajoutés :
9 mars 2020
Lancement de l'API Display & Video 360 v1. Il s'agit de la version initiale de l'API.
Problèmes connus
Aucune.