# Archived release notes This page provides release notes for sunset versions of the Display \& Video 360 API. Navigate to our [main release notes page](https://developers.google.com/display-video/api/release-notes) for all releases to live versions. ## December 4, 2024 ### New Features Added support for Core and Tubi [`Exchange`](https://developers.google.com/display-video/api/reference/rest/v3/Exchange) values. Increased the maximum allowable page size for [`firstAndThirdPartyAudiences.list`](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/list) from `200` to `5000`. Update the `pageSize` parameter of your `firstAndThirdPartyAudiences.list` requests to further optimize your quota usage. #### v3 - The following enum values have been added: | Enum | Value(s) | |---|---| | `https://developers.google.com/display-video/api/reference/rest/v3/Exchange` | `EXCHANGE_CORE` `EXCHANGE_TUBI` | - The max page size has been increased for the following list methods: | Method | New Max Page Size | |---|---| | `https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/list#body.QUERY_PARAMETERS.page_size` | `5000` | ## October 22, 2024 ### New Features Added support for the cost-per-view performance goal. Added ability to set and retrieve targeting of connected devices. Added new Adloox brand safety settings under [third-party verifier targeting](https://support.google.com/displayvideo/answer/3032915). Added support for downloading [v8 Structured Data Files](https://developers.google.com/display-video/api/structured-data-file/v8/Campaign), which is currently in closed beta. #### v3 - The following fields have been added: | Object | Field(s) | |---|---| | `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox` | `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.adult_explicit_sexual_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.arms_ammunition_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.crime_harmful_acts_individuals_society_human_rights_violations_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.death_injury_military_conflict_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.debated_sensitive_social_issue_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.display_iab_viewability` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.excluded_fraud_ivt_mfa_categories` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.hate_speech_acts_aggression_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.illegal_drugs_tobacco_ecigarettes_vaping_alcohol_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.misinformation_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.obscenity_profanity_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.online_piracy_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.spam_harmful_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.terrorism_content` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Adloox.FIELDS.video_iab_viewability` | - The following enum values have been added: | Enum | Value(s) | |---|---| | `https://developers.google.com/display-video/api/reference/rest/v3/DeviceType` | `DEVICE_TYPE_CONNECTED_DEVICE` | | `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.campaigns#PerformanceGoalType` | `PERFORMANCE_GOAL_TYPE_CPV` | | `https://developers.google.com/display-video/api/reference/rest/v3/SdfConfig#SdfVersion` | `SDF_VERSION_8` | ### Deprecated values Removed support for SDF v5.5 given its [sunset on October 3, 2024](https://ads-developers.googleblog.com/2024/03/deprecation-of-structured-data-files-v55.html). #### v3 - The following enum values have been deprecated: | Enum | Value(s) | |---|---| | `https://developers.google.com/display-video/api/reference/rest/v3/SdfConfig#SdfVersion` | `SDF_VERSION_5_5` | ## August 15, 2024 ### New Features Added support for Netflix [`Exchange`](https://developers.google.com/display-video/api/reference/rest/v3/Exchange) type. #### v3 - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v3/Exchange) | EXCHANGE_NETFLIX | #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_NETFLIX | ## July 15, 2024 ### New Features Added support for downloading Line Item and Ad Group Structured Data Files in [QA format](https://developers.google.com/display-video/api/structured-data-file/format#format_types) in v3. #### v3 - The following fields have been added: | Resource | Field(s) | |---|---| | [IdFilter](https://developers.google.com/display-video/api/reference/rest/v3/sdfdownloadtasks/create#IdFilter) | [adGroupQaIds](https://developers.google.com/display-video/api/reference/rest/v3/sdfdownloadtasks/create#IdFilter.FIELDS.ad_group_qa_ids) [lineItemQaIds](https://developers.google.com/display-video/api/reference/rest/v3/sdfdownloadtasks/create#IdFilter.FIELDS.line_item_qa_ids) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [FileType](https://developers.google.com/display-video/api/reference/rest/v3/sdfdownloadtasks/create#FileType) | FILE_TYPE_AD_GROUP_QA FILE_TYPE_LINE_ITEM_QA | ## June 17, 2024 ### New Features Added support for managing keyword targeting assigned at the advertiser level. Added new [`optimizationObjective`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder.FIELDS.optimization_objective) field to the insertion order resource. `optimizationObjective` is only available to allowlisted customers. #### v3 - The following fields have been added: | Resource | Field(s) | |---|---| | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder) | [optimizationObjective](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder.FIELDS.optimization_objective) | - The following methods now support the following targeting types: | Targeting Type | Method(s) | |---|---| | TARGETING_TYPE_KEYWORD | [advertisers.editAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v3/advertisers/editAssignedTargetingOptions) [advertisers.listAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v3/advertisers/listAssignedTargetingOptions) [advertisers.targetingType.assignedTargetingOptions.create](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.targetingTypes.assignedTargetingOptions/create) [advertisers.targetingType.assignedTargetingOptions.delete](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.targetingTypes.assignedTargetingOptions/delete) [advertisers.targetingType.assignedTargetingOptions.get](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.targetingTypes.assignedTargetingOptions/get) [advertisers.targetingType.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.targetingTypes.assignedTargetingOptions/list) | #### v2 - The following methods now support the following targeting types: | Targeting Type | Method(s) | |---|---| | TARGETING_TYPE_KEYWORD | [advertisers.editAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers/editAssignedTargetingOptions) [advertisers.listAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers/listAssignedTargetingOptions) [advertisers.targetingType.assignedTargetingOptions.create](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.targetingTypes.assignedTargetingOptions/create) [advertisers.targetingType.assignedTargetingOptions.delete](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.targetingTypes.assignedTargetingOptions/delete) [advertisers.targetingType.assignedTargetingOptions.get](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.targetingTypes.assignedTargetingOptions/get) [advertisers.targetingType.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.targetingTypes.assignedTargetingOptions/list) | ## May 30, 2024 ### New Features Added support for Structured Data Files (SDF) version 7.1. #### v3 - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v3/SdfConfig#SdfVersion.ENUM_VALUES.SDF_VERSION_7_1) | SDF_VERSION_7_1 | #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v2/SdfConfig#SdfVersion.ENUM_VALUES.SDF_VERSION_7_1) | SDF_VERSION_7_1 | ## April 23, 2024 ### New Features Added support for new KPI types, exchanges, and app platforms. #### v3 - The following fields have been added: | Resource | Field(s) | |---|---| | [Kpi](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#Kpi) | [kpiAlgorithmId](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#Kpi.FIELDS.kpi_algorithm_id) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [AppPlatform](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppPlatform) | APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV | | [Exchange](https://developers.google.com/display-video/api/reference/rest/v3/Exchange) | EXCHANGE_DRAX | | [KpiType](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#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](https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy#YoutubeAndPartnersBiddingStrategyType) | YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM | #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [AppPlatform](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppPlatform) | APP_PLATFORM_LG_TV APP_PLATFORM_VIZIO_TV | | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_DRAX | | [YoutubeAndPartnersBiddingStrategyType](https://developers.google.com/display-video/api/reference/rest/v2/YoutubeAndPartnersBiddingStrategy#YoutubeAndPartnersBiddingStrategyType) | YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM | ## February 28, 2024 ### New Features Added the ability to explicitly remove members from customer match audiences. Added support for targeting new [exchanges](https://developers.google.com/display-video/api/reference/rest/v3/Exchange). #### v3 - The following fields have been added: | Resource | Field(s) | |---|---| | [firstAndThirdPartyAudiences.editCustomerMatchMembers](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body) | [removedContactInfoList](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body.FIELDS.removed_contact_info_list) [removedMobileDeviceIdList](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body.FIELDS.removed_mobile_device_id_list) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v3/Exchange) | EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID | #### v2 - The following fields have been added: | Resource | Field(s) | |---|---| | [firstAndThirdPartyAudiences.editCustomerMatchMembers](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body) | [removedContactInfoList](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body.FIELDS.removed_contact_info_list) [removedMobileDeviceIdList](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences/editCustomerMatchMembers#body.request_body.FIELDS.removed_mobile_device_id_list) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_ADMOST_GBID EXCHANGE_APPLOVIN_GBID EXCHANGE_CHARTBOOST_GBID EXCHANGE_FYBER_GBID EXCHANGE_TOPON_GBID EXCHANGE_UNITY_GBID | ## January 29, 2024 ### New Features Added the ability to retrieve Floodlight activities through a new [`floodlightGroups.floodlightActivities`](https://developers.google.com/display-video/api/reference/rest/v3/floodlightGroups.floodlightActivities) service. Added a new field communicating whether a YouTube \& Partners line item includes Google TV inventory in its targeting. Added a new field to relay the last login time for a [Display \& Video 360 user](https://developers.google.com/display-video/api/reference/rest/v3/users#User). #### v3 - The following methods have been added: | Service | Method(s) | |---|---| | [floodlightGroups.floodlightActivities](https://developers.google.com/display-video/api/reference/rest/v3/floodlightGroups.floodlightActivities) | [get](https://developers.google.com/display-video/api/reference/rest/v3/floodlightGroups.floodlightActivities/get) [list](https://developers.google.com/display-video/api/reference/rest/v3/floodlightGroups.floodlightActivities/list) | - The following fields have been added: | Resource | Field(s) | |---|---| | [User](https://developers.google.com/display-video/api/reference/rest/v3/users#User) | [lastLoginTime](https://developers.google.com/display-video/api/reference/rest/v3/users#User.FIELDS.last_login_time) | | [YoutubeAndPartnersInventorySourceConfig](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig) | [includeGoogleTv](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig.FIELDS.include_google_tv) | #### v2 - The following methods have been added: | Service | Method(s) | |---|---| | [floodlightGroups.floodlightActivities](https://developers.google.com/display-video/api/reference/rest/v2/floodlightGroups.floodlightActivities) | [get](https://developers.google.com/display-video/api/reference/rest/v2/floodlightGroups.floodlightActivities/get) [list](https://developers.google.com/display-video/api/reference/rest/v2/floodlightGroups.floodlightActivities/list) | - The following fields have been added: | Resource | Field(s) | |---|---| | [User](https://developers.google.com/display-video/api/reference/rest/v2/users#User) | [lastLoginTime](https://developers.google.com/display-video/api/reference/rest/v2/users#User.FIELDS.last_login_time) | | [YoutubeAndPartnersInventorySourceConfig](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig) | [includeGoogleTv](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig.FIELDS.include_google_tv) | ## November 14, 2023 ### New Features Added support for passing end-user consent when uploading Customer Match audience members in all live versions. #### v3 - The following fields have been added: | Resource | Field(s) | |---|---| | [ContactInfoList](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList) | [consent](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#ContactInfoList.FIELDS.consent) | | [MobileDeviceIdList](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList) | [consent](https://developers.google.com/display-video/api/reference/rest/v3/firstAndThirdPartyAudiences#MobileDeviceIdList.FIELDS.consent) | #### v2 - The following fields have been added: | Resource | Field(s) | |---|---| | [ContactInfoList](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences#ContactInfoList) | [consent](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences#ContactInfoList.FIELDS.consent) | | [MobileDeviceIdList](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences#MobileDeviceIdList) | [consent](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences#MobileDeviceIdList.FIELDS.consent) | ## October 31, 2023 ### New Features Moved v3 out of public beta and into general availability. Renamed an [`AdGroupFormat`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat) enum value in v3 to more accurately reflect the relevant format. Added support for Structured Data Files v7 with the addition of the `SDF_VERSION_7` enum value in v2 and v3. #### v3 - The following enum values have been removed: | Enum | Value(s) | |---|---| | [AdGroupFormat](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat) | AD_GROUP_FORMAT_ACTION | - The following enum values have been added: | Enum | Value(s) | |---|---| | [AdGroupFormat](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroupFormat) | AD_GROUP_FORMAT_RESPONSIVE | | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v3/SdfConfig#SdfVersion) | SDF_VERSION_7 | #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v2/SdfConfig#SdfVersion) | SDF_VERSION_7 | ## October 2, 2023 ### New Features Released v3 in public beta, which includes the following changes: - The ability to fully manage proximity location lists, enabling the use of the [`advertisers.locationLists.assignedLocations`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists.assignedLocations#methods) service to create and delete locations assigned to `TARGETING_LOCATION_TYPE_PROXIMITY` [`LocationList`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList) resources. - A new boolean [`enableOptimizedTargeting`](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig#FIELDS.enable_optimized_targeting) field, which replaces the `targetingExpansionLevel` field in the [`TargetingExpansionConfig`](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig) object. - The requirement of the [`billingConfig`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers#Advertiser.FIELDS.billing_config) field in the [`Advertiser`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers#Advertiser) resource, which must be included when making [`advertisers.create`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers/create) requests, and a new [`billingConfig`](https://developers.google.com/display-video/api/reference/rest/v3/partners#Partner.FIELDS.billing_config) field in the [`Partner`](https://developers.google.com/display-video/api/reference/rest/v3/partners#Partner) resource. - New [`AdGroup`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups#AdGroup) and [`AdGroupAd`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroupAds#AdGroupAd) resources that replace the `YoutubeAdGroup` and `YoutubeAdGroupAd` resources in v2. Follow the steps in our [migration guide](https://developers.google.com/display-video/api/v3-migration-guide) to migrate from v2 to v3. Added support for 3 new [`LineItemType`](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#LineItemType) values, one new [`YoutubeAndPartnersBiddingStrategyType`](https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy#YoutubeAndPartnersBiddingStrategyType), and one new [`PartnerCostType`](https://developers.google.com/display-video/api/reference/rest/v3/PartnerCost#PartnerCostType) in v2 and v3. #### v3 - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.adGroupAds](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroupAds) | [get](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroupAds/get) [list](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroupAds/list) | | [advertisers.adGroups](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups) | [bulkListAdGroupAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/bulkListAdGroupAssignedTargetingOptions) [get](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/get) [list](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups/list) | | [advertisers.adGroups.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions) | [get](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.adGroups.targetingTypes.assignedTargetingOptions/list) | | [customBiddingAlgorithms](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms) | [uploadRules](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms/uploadRules) | | [customBiddingAlgorithms.rules](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms.rules) | [create](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms.rules/create) [get](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms.rules/get) [list](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms.rules/list) | - The following methods have been removed: | Service | Method(s) | |---|---| | advertisers.manualTriggers | activate create deactivate get list patch | | advertisers.youtubeAdGroupAds | get list | | advertisers.youtubeAdGroups | bulkListAdGroupAssignedTargetingOptions get list | | advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions | get list | - The following method behavior has changed: | Method | Change(s) | |---|---| | [advertisers.locationLists.create](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists/create) | Now supports creating `TARGETING_LOCATION_TYPE_PROXIMITY` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList` resources. | | [advertisers.locationLists.patch](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists/patch) | Now supports updating `TARGETING_LOCATION_TYPE_PROXIMITY` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList` resources. | | [advertisers.locationLists.assignedLocations.bulkEdit](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists.assignedLocations/bulkEdit) | Now supports bulk editing the `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists.assignedLocations#AssignedLocation` resources in `TARGETING_LOCATION_TYPE_PROXIMITY` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList` resources. | | [advertisers.locationLists.assignedLocations.create](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists.assignedLocations/create) | Now supports creating `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists.assignedLocations#AssignedLocation` resources in `TARGETING_LOCATION_TYPE_PROXIMITY` `https://developers.google.com/display-video/api/reference/rest/v3/advertisers.locationLists#LocationList` resources. | - The following query parameters have been added: | Method | Parameter(s) | |---|---| | [inventorySources.get](https://developers.google.com/display-video/api/reference/rest/v3/inventorySources/get) | [advertiserId](https://developers.google.com/display-video/api/reference/rest/v3/inventorySources/get#body.advertiser_id) | - The following fields have been made required: | Resource | Field(s) | |---|---| | [Advertiser](https://developers.google.com/display-video/api/reference/rest/v3/advertisers#Advertiser) | [billingConfig](https://developers.google.com/display-video/api/reference/rest/v3/advertisers#Advertiser.FIELDS.billing_config) | - The following fields have been added: | Resource | Field(s) | |---|---| | [BiddingStrategy](https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy) | [youtubeAndPartnersBid](https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy#FIELDS.youtube_and_partners_bid) | | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder) | [kpi](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder.FIELDS.kpi) | | [Partner](https://developers.google.com/display-video/api/reference/rest/v3/partners#Partner) | [billingConfig](https://developers.google.com/display-video/api/reference/rest/v3/partners#Partner.FIELDS.billing_config) | | [TargetingExpansionConfig](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig) | [audienceExpansionLevel](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig#FIELDS.audience_expansion_level) [audienceExpansionSeedListExcluded](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig#FIELDS.audience_expansion_seed_list_excluded) [enableOptimizedTargeting](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig#FIELDS.enable_optimized_targeting) | | [YoutubeAndPartnersSettings](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersSettings) | [thirdPartyMeasurementConfigs](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.third_party_measurement_configs) | | [YoutubeAndPartnersInventorySourceConfig](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig) | [includeYoutube](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig.FIELDS.include_youtube) | - The following fields have been removed: | Resource | Field(s) | |---|---| | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.insertionOrders#InsertionOrder) | performanceGoal billableOutcome | | [TargetingExpansionConfig](https://developers.google.com/display-video/api/reference/rest/v3/TargetingExpansionConfig) | excludeFirstPartyAudience targetingExpansionLevel | | [YoutubeAndPartnersSettings](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersSettings) | biddingStrategy thirdPartyMeasurementSettings | | [YoutubeAndPartnersInventorySourceConfig](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#YoutubeAndPartnersInventorySourceConfig) | includeYoutubeSearch includeYoutubeVideos | - The following enum values have been added: | Enum | Value(s) | |---|---| | [CustomBiddingAlgorithmType](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms#CustomBiddingAlgorithmType) | RULE_BASED | | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#LineItemType) | LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW | | [PartnerCostType](https://developers.google.com/display-video/api/reference/rest/v3/PartnerCost#PartnerCostType) | PARTNER_COST_TYPE_SCIBIDS_FEE | | [ReadinessState](https://developers.google.com/display-video/api/reference/rest/v3/customBiddingAlgorithms#ReadinessState) | READINESS_STATE_EVALUATION_FAILURE | | [YoutubeAndPartnersBiddingStrategyType](https://developers.google.com/display-video/api/reference/rest/v3/BiddingStrategy#YoutubeAndPartnersBiddingStrategyType) | YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV | - The following enum values have been removed: | Enum | Value(s) | |---|---| | [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v3/advertisers.lineItems#LineItemWarningMessage) | DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemType) | LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW | | [PartnerCostType](https://developers.google.com/display-video/api/reference/rest/v2/PartnerCost#PartnerCostType) | PARTNER_COST_TYPE_SCIBIDS_FEE | | [YoutubeAndPartnersBiddingStrategyType](https://developers.google.com/display-video/api/reference/rest/v2/YoutubeAndPartnersBiddingStrategy#YoutubeAndPartnersBiddingStrategyType) | YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV | ## August 25, 2023 ### New Features Added support for two [exchanges](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) and two new [YouTube \& Partners bidding strategy types](https://developers.google.com/display-video/api/reference/rest/v2/YoutubeAndPartnersBiddingStrategy#YoutubeAndPartnersBiddingStrategyType). Added a new [`effectiveContentCategory`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.effective_content_category) field to YouTube \& Partners line items to surface the [`YoutubeAndPartnersContentCategory`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersContentCategory) used by the line item when considering values assigned at both the advertiser and line item level. #### v2 - The following fields have been added: | Resource | Field(s) | |---|---| | [YoutubeAndPartnersSettings](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings) | [effectiveContentCategory](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.effective_content_category) | - The following fields have been removed: | Resource | Field(s) | |---|---| | [InventorySource](https://developers.google.com/display-video/api/reference/rest/v2/inventorySources#InventorySource) | subSitePropertyId | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_HIVESTACK EXCHANGE_RESET_DIGITAL | | [YoutubeAndPartnersBiddingStrategyType](https://developers.google.com/display-video/api/reference/rest/v2/YoutubeAndPartnersBiddingStrategy#YoutubeAndPartnersBiddingStrategyType) | YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS | ## June 5, 2023 ### New Features Added a new [`SdfVersion`](https://developers.google.com/display-video/api/reference/rest/v2/SdfConfig#SdfVersion) value for [Structured Data Files (SDF) v6](https://developers.google.com/display-video/api/structured-data-file/v6/Campaign) in v1 and v2. #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v2/SdfConfig#sdfversion) | SDF_VERSION_6 | #### v1 - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#sdfversion) | SDF_VERSION_6 | ## March 9, 2023 ### New Features Added a new [`LineItemWarningMessage`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemWarningMessage) value that will be assigned to a line item's [`warningMessages`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItem.FIELDS.warning_messages) field if it has the deprecated [`excludeFirstPartyAudience`](https://developers.google.com/display-video/api/reference/rest/v2/TargetingExpansionConfig#FIELDS.exclude_first_party_audience) field set to `true`. The [`excludeFirstPartyAudience`](https://developers.google.com/display-video/api/reference/rest/v2/TargetingExpansionConfig#FIELDS.exclude_first_party_audience) field will be sunset and set to `false` after **March 25, 2023**. #### v2 - The following enum values have been added: | Enum | Value(s) | |---|---| | [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemWarningMessage) | DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | #### v1 - The following enum values have been added: | Enum | Value(s) | |---|---| | [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage) | DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION | ## February 8, 2023 ### New Features Added the ability to retrieve [`YouTubeAdGroup`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups#YoutubeAdGroup) and [`YouTubeAdGroupAd`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroupAds#YoutubeAdGroupAd) resources, as well as [YouTube Ad Group resource targeting](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions). In addition, we've also added new retrievable [targeting types](https://developers.google.com/display-video/api/reference/rest/v2/TargetingType) used on the YouTube Ad Groups level. Read our [new guide page on retrieving YouTube \& Partners resources](https://developers.google.com/display-video/api/guides/managing-line-items/youtube) for more information. Added support for four additional [exchanges](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) in v1 and v2. #### v2 - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.youtubeAdGroupAds](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroupAds) | [get](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroupAds/get) [list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroupAds/list) | | [advertisers.youtubeAdGroups](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups) | [bulkListAdGroupAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups/bulkListAdGroupAssignedTargetingOptions) [get](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups/get) [list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups/list) | | [advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions) | [get](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions/list) | - The following fields have been added: | Service | Method(s) | |---|---| | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [sessionPositionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.session_position_details) [youtubeChannelDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.youtube_channel_details) [youtubeVideoDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.youtube_video_details) | | [YoutubeAndPartnersSettings](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings) | [leadFormId](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.lead_form_id) [linkedMerchantId](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.linked_merchant_id) [relatedVideoIds](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.related_video_ids) [targetFrequency](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.target_frequency) [videoAdSequenceSettings](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#YoutubeAndPartnersSettings.FIELDS.video_ad_sequence_settings) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE | | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemType) | LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY | | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v2/TargetingType) | TARGETING_TYPE_SESSION_POSITION TARGETING_TYPE_YOUTUBE_CHANNEL TARGETING_TYPE_YOUTUBE_VIDEO | #### v1 - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | EXCHANGE_APPLOVIN EXCHANGE_CONNATIX EXCHANGE_JCD EXCHANGE_PLACE_EXCHANGE | ## December 6, 2022 ### New Features Moved v2 out of public beta and into general availability. Added a new [`assignedTargetingOptionIdAlias`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id_alias) field to the [`AssignedTargetingOption`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) resource, which can be used in place of the [`assignedTargetingOptionId`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id) when retrieving and deleting targeting. This field is only set for assigned targeting options of targeting types that are assigned via enum. The alias value is the relevant enum value as a string. Added a new [`billingConfig`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers#Advertiser.FIELDS.billing_config) field to the [`Advertiser`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers#Advertiser) resource. Added support for retrieving YouTube \& Partners over-the-top line items, identified by three new [`LineItemType`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemType) values. Increased the max page size to 200 for numerous `list` methods in v1 and v2. The default page size is unchanged. #### v2 - The following fields have been added: | Resource | Field(s) | |---|---| | [Advertiser](https://developers.google.com/display-video/api/reference/rest/v2/advertisers#Advertiser) | [billingConfig](https://developers.google.com/display-video/api/reference/rest/v2/advertisers#Advertiser.FIELDS.billing_config) | | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [assignedTargetingOptionIdAlias](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id_alias) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#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 | - The max page size has been increased for the following list methods: | Method | New Max Page Size | |---|---| | [advertisers.campaigns.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns/list) | 200 | | [advertisers.channels.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.channels/list) | 200 | | [advertisers.creatives.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.creatives/list) | 200 | | [advertisers.invoices.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.invoices/list) | 200 | | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/list) | 200 | | [advertisers.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers/list) | 200 | | [advertisers.locationLists.assignedLocations.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.locationLists.assignedLocations/list) | 200 | | [advertisers.locationLists.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.locationLists/list) | 200 | | [advertisers.manualTriggers.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.manualTriggers/list) | 200 | | [advertisers.negativeKeywordLists.list](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.negativeKeywordLists/list) | 200 | | [combinedAudiences.list](https://developers.google.com/display-video/api/reference/rest/v2/combinedAudiences/list) | 200 | | [customBiddingAlgorithms.list](https://developers.google.com/display-video/api/reference/rest/v2/customBiddingAlgorithms/list) | 200 | | [customBiddingAlgorithms.scripts.list](https://developers.google.com/display-video/api/reference/rest/v2/customBiddingAlgorithms.scripts/list) | 200 | | [customLists.list](https://developers.google.com/display-video/api/reference/rest/v2/customLists/list) | 200 | | [firstAndThirdPartyAudiences.list](https://developers.google.com/display-video/api/reference/rest/v2/firstAndThirdPartyAudiences/list) | 200 | | [googleAudiences.list](https://developers.google.com/display-video/api/reference/rest/v2/googleAudiences/list) | 200 | | [guaranteedOrders.list](https://developers.google.com/display-video/api/reference/rest/v2/guaranteedOrders/list) | 200 | | [inventorySourceGroups.list](https://developers.google.com/display-video/api/reference/rest/v2/inventorySourceGroups/list) | 200 | | [inventorySources.list](https://developers.google.com/display-video/api/reference/rest/v2/inventorySources/list) | 200 | | [partners.channels.list](https://developers.google.com/display-video/api/reference/rest/v2/partners.channels/list) | 200 | | [partners.list](https://developers.google.com/display-video/api/reference/rest/v2/partners/list) | 200 | | [partners.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v2/partners.targetingTypes.assignedTargetingOptions/list) | 200 | | [targetingTypes.targetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v2/targetingTypes.targetingOptions/list) | 200 | | [targetingTypes.targetingOptions.search](https://developers.google.com/display-video/api/reference/rest/v2/targetingTypes.targetingOptions/search) | 200 | | [users.list](https://developers.google.com/display-video/api/reference/rest/v2/users/list) | 200 | #### v1 - The max page size has been increased for the following list methods: | Method | New Max Page Size | |---|---| | [advertisers.campaigns.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/list) | 200 | | [advertisers.channels.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels/list) | 200 | | [advertisers.creatives.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list) | 200 | | [advertisers.invoices.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.invoices/list) | 200 | | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list) | 200 | | [advertisers.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/list) | 200 | | [advertisers.locationLists.assignedLocations.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations/list) | 200 | | [advertisers.locationLists.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists/list) | 200 | | [advertisers.manualTriggers.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/list) | 200 | | [advertisers.negativeKeywordLists.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/list) | 200 | | [combinedAudiences.list](https://developers.google.com/display-video/api/reference/rest/v1/combinedAudiences/list) | 200 | | [customBiddingAlgorithms.list](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/list) | 200 | | [customBiddingAlgorithms.scripts.list](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/list) | 200 | | [customLists.list](https://developers.google.com/display-video/api/reference/rest/v1/customLists/list) | 200 | | [firstAndThirdPartyAudiences.list](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/list) | 200 | | [googleAudiences.list](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences/list) | 200 | | [guaranteedOrders.list](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/list) | 200 | | [inventorySourceGroups.list](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/list) | 200 | | [inventorySources.list](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/list) | 200 | | [partners.channels.list](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels/list) | 200 | | [partners.list](https://developers.google.com/display-video/api/reference/rest/v1/partners/list) | 200 | | [partners.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions/list) | 200 | | [targetingTypes.targetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/list) | 200 | | [targetingTypes.targetingOptions.search](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search) | 200 | | [users.list](https://developers.google.com/display-video/api/reference/rest/v1/users/list) | 200 | ### Known issues This update fixes the following known issues in v2: - Assigned targeting options of targeting types that are [assigned using enum values in v2](https://developers.google.com/display-video/api/v2-migration-guide#update_calls_to_targeting_methods) were not able to be removed or retrieved using their [`assignedTargetingOptionId`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id) and instead expected users to use the enum value. With this update, these assigned targeting options can be removed or retrieved using either the [`assignedTargetingOptionId`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id) or the enum value, identified by the new [`assignedTargetingOptionIdAlias`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id_alias) field in the [`AssignedTargetingOption`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) resource. - The line item [`bulkUpdate`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkUpdate) request was not correctly using the `advertisersId` request parameter, returning an error. With this update, the method has been fixed and the request parameter has been renamed from the `advertisersId` to [`advertiserId`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkUpdate#body.PATH_PARAMETERS.advertiser_id). ## October 27, 2022 Added the ability to duplicate an existing line item within the parent [`InsertionOrder`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders#InsertionOrder). Introduced partial insertion order targeting write support for a subset of targeting types with the addition of [`create`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/create) and [`delete`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/delete) methods to the [`advertisers.insertionOrders.targetingTypes.assignedTargetingOptions`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions) service. ### New Features #### v2 - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.insertionOrders.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions) | [create](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/create) [delete](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/delete) | | [advertisers.lineItems](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems) | [duplicate](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/duplicate) | #### v1 No new features have been added to v1. ## September 20, 2022 Released v2 in public beta, which includes the following changes: - The ability to retrieve YouTube \& Partners line items and their targeting settings using `get` and `list` methods in the [`advertisers.lineItems`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems) and [`advertisers.lineItems.targetingTypes.assignedTargetingOptions`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions) services. - Two new bulk targeting methods in the [`advertisers.lineItems`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems) service that enable [editing](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkEditAssignedTargetingOptions) and [retrieving](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkListAssignedTargetingOptions) assigned targeting across multiple line items with a single request. - A new [`bulkUpdate`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkUpdate) method that allows users to update the [`entityStatus`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItem.FIELDS.entity_status) of multiple line items in a single request. - New targeting logic that requires [`AssignedTargetingOption`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems.targetingTypes.assignedTargetingOptions) resources of a [subset of targeting types](https://developers.google.com/display-video/api/v2-migration-guide#update_calls_to_targeting_methods) to be assigned and retrieved using enum values instead of targeting option IDs retrieved using the [`targetingTypes.targetingOptions`](https://developers.google.com/display-video/api/reference/rest/v2/targetingTypes.targetingOptions) service. Follow the steps in our [migration guide](https://developers.google.com/display-video/api/v2-migration-guide) to migrate from v1 to v2. Added support for three new [exchanges](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) in v1. ### New Features #### v2 The following is a list of changes between v1 and v2: - The following methods have been added in v2: | Service | Method(s) | |---|---| | [advertisers.lineItems](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems) | [bulkEditAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkEditAssignedTargetingOptions) [bulkListAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkListAssignedTargetingOptions) [bulkUpdate](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems/bulkUpdate) | - The following methods have been removed in v2: | Service | Method(s) | |---|---| | [advertisers.lineItems](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems) | bulkEditLineItemAssignedTargetingOptions bulkListLineItemAssignedTargetingOptions | - The following methods have been renamed in v2: | Service | Old Method Name | New Method Name | |---|---|---| | [advertisers](https://developers.google.com/display-video/api/reference/rest/v2/advertisers) | bulkEditAdvertiserAssignedTargetingOptions bulkListAdvertiserAssignedTargetingOptions | [editAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers/editAssignedTargetingOptions) [listAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers/listAssignedTargetingOptions) | | [advertisers.campaigns](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns) | bulkListCampaignAssignedTargetingOptions | [listAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns/listAssignedTargetingOptions) | | [advertisers.insertionOrders](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders) | bulkListInsertionOrderAssignedTargetingOptions | [listAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.insertionOrders/listAssignedTargetingOptions) | | [partners](https://developers.google.com/display-video/api/reference/rest/v2/partners) | bulkEditPartnerAssignedTargetingOptions | [editAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v2/partners/editAssignedTargetingOptions) | - [`AssignedTargetingOption`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) resources of the following [targeting types](https://developers.google.com/display-video/api/reference/rest/v2/TargetingType) use enums for targeting assignment in v2. The [`assignedTargetingOptionId`](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.assigned_targeting_option_id) field for `AssignedTargetingOption` resources of these targeting types have also been updated in v2 to use string versions of the enum values: | Targeting Type | Enum Type | |---|---| | TARGETING_TYPE_AGE_RANGE | [AgeRange](https://developers.google.com/display-video/api/reference/rest/v2/AgeRange) | | TARGETING_TYPE_CONTENT_INSTREAM_POSITION | [ContentInstreamPosition](https://developers.google.com/display-video/api/reference/rest/v2/ContentInstreamPosition) | | TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION | [ContentOutstreamPosition](https://developers.google.com/display-video/api/reference/rest/v2/ContentOutstreamPosition) | | TARGETING_TYPE_DEVICE_TYPE | [DeviceType](https://developers.google.com/display-video/api/reference/rest/v2/DeviceType) | | TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION | [ContentRatingTier](https://developers.google.com/display-video/api/reference/rest/v2/ContentRatingTier) | | TARGETING_TYPE_ENVIRONMENT | [Environment](https://developers.google.com/display-video/api/reference/rest/v2/Environment) | | TARGETING_TYPE_EXCHANGE | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | | TARGETING_TYPE_GENDER | [Gender](https://developers.google.com/display-video/api/reference/rest/v2/Gender) | | TARGETING_TYPE_HOUSEHOLD_INCOME | [HouseholdIncome](https://developers.google.com/display-video/api/reference/rest/v2/HouseholdIncome) | | TARGETING_TYPE_NATIVE_CONTENT_POSITION | [NativeContentPosition](https://developers.google.com/display-video/api/reference/rest/v2/NativeContentPosition) | | TARGETING_TYPE_OMID | [Omid](https://developers.google.com/display-video/api/reference/rest/v2/Omid) | | TARGETING_TYPE_PARENTAL_STATUS | [ParentalStatus](https://developers.google.com/display-video/api/reference/rest/v2/ParentalStatus) | | TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION | [SensitiveCategory](https://developers.google.com/display-video/api/reference/rest/v2/SensitiveCategory) | | TARGETING_TYPE_VIDEO_PLAYER_SIZE | [VideoPlayerSize](https://developers.google.com/display-video/api/reference/rest/v2/VideoPlayerSize) | | TARGETING_TYPE_VIEWABILITY | [Viewability](https://developers.google.com/display-video/api/reference/rest/v2/Viewability) | - The following fields have been added in v2: | Resource | Field(s) | |---|---| | [CustomBiddingAlgorithm](https://developers.google.com/display-video/api/reference/rest/v2/customBiddingAlgorithms#CustomBiddingAlgorithm) | [modelDetails](https://developers.google.com/display-video/api/reference/rest/v2/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.model_details) | | [DeviceTypeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DeviceTypeAssignedTargetingOptionDetails) | [youtubeAndPartnersBidMultiplier](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DeviceTypeAssignedTargetingOptionDetails.FIELDS.youtube_and_partners_bid_multiplier) | | [DigitalContentLabelAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DigitalContentLabelAssignedTargetingOptionDetails) | [excludedContentRatingTier](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DigitalContentLabelAssignedTargetingOptionDetails.FIELDS.excluded_content_rating_tier) | | [ExchangeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ExchangeAssignedTargetingOptionDetails) | [exchange](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ExchangeAssignedTargetingOptionDetails.FIELDS.exchange) | | [FrequencyCap](https://developers.google.com/display-video/api/reference/rest/v2/FrequencyCap) | [maxViews](https://developers.google.com/display-video/api/reference/rest/v2/FrequencyCap#FIELDS.max_views) | | [LineItem](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItem) | [youtubeAndPartnersSettings](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItem.FIELDS.youtube_and_partners_settings) | | [ProximityLocationListAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ProximityLocationListAssignedTargetingOptionDetails) | [proximityRadius](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ProximityLocationListAssignedTargetingOptionDetails.FIELDS.proximity_radius) [proximityRadiusUnit](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ProximityLocationListAssignedTargetingOptionDetails.FIELDS.proximity_radius_unit) | | [SensitiveCategoryAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.SensitiveCategoryAssignedTargetingOptionDetails) | [excludedSensitiveCategory](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.SensitiveCategoryAssignedTargetingOptionDetails.FIELDS.excluded_sensitive_category) | - The following fields have been removed in v2: | Resource | Field(s) | |---|---| | [AgeRangeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AgeRangeAssignedTargetingOptionDetails) | targetingOptionId | | [ContentInstreamPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentInstreamPositionAssignedTargetingOptionDetails) | targetingOptionId | | [ContentOutstreamPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentOutstreamPositionAssignedTargetingOptionDetails) | targetingOptionId | | [CustomBiddingAlgorithm](https://developers.google.com/display-video/api/reference/rest/v2/customBiddingAlgorithms#CustomBiddingAlgorithm) | customBiddingAlgorithmState | | [DeviceTypeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DeviceTypeAssignedTargetingOptionDetails) | targetingOptionId | | [DigitalContentLabelAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DigitalContentLabelAssignedTargetingOptionDetails) | contentRatingTier excludedTargetingOptionId | | [EnvironmentAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.EnvironmentAssignedTargetingOptionDetails) | targetingOptionId | | [ExchangeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ExchangeAssignedTargetingOptionDetails) | targetingOptionId | | [GenderAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.GenderAssignedTargetingOptionDetails) | targetingOptionId | | [HouseholdIncomeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.HouseholdIncomeAssignedTargetingOptionDetails) | targetingOptionId | | [LineItem](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItem) | inventorySourceIds | | [LineItemFlight](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemFlight) | triggerId | | [NativeContentPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.NativeContentPositionAssignedTargetingOptionDetails) | targetingOptionId | | [OmidAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.OmidAssignedTargetingOptionDetails) | targetingOptionId | | [ParentalStatusAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ParentalStatusAssignedTargetingOptionDetails) | targetingOptionId | | [ProximityLocationListAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ProximityLocationListAssignedTargetingOptionDetails) | proximityRadiusRange | | [SensitiveCategoryAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.SensitiveCategoryAssignedTargetingOptionDetails) | excludedTargetingOptionId sensitiveCategory | | [VideoPlayerSizeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.VideoPlayerSizeAssignedTargetingOptionDetails) | targetingOptionId | | [ViewabilityAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ViewabilityAssignedTargetingOptionDetails) | targetingOptionId | - The following fields have been made required in v2: | Resource | Field(s) | |---|---| | [AgeRangeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AgeRangeAssignedTargetingOptionDetails) | [ageRange](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AgeRangeAssignedTargetingOptionDetails.FIELDS.age_range) | | [ContentInstreamPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentInstreamPositionAssignedTargetingOptionDetails) | [contentInstreamPosition](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentInstreamPositionAssignedTargetingOptionDetails.FIELDS.content_instream_position) | | [ContentOutstreamPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentOutstreamPositionAssignedTargetingOptionDetails) | [contentOutstreamPosition](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ContentOutstreamPositionAssignedTargetingOptionDetails.FIELDS.content_outstream_position) | | [DeviceTypeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DeviceTypeAssignedTargetingOptionDetails) | [deviceType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DeviceTypeAssignedTargetingOptionDetails.FIELDS.device_type) | | [DigitalContentLabelAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DigitalContentLabelAssignedTargetingOptionDetails) | [excludedContentRatingTier](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DigitalContentLabelAssignedTargetingOptionDetails.FIELDS.excluded_content_rating_tier) | | [EnvironmentAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.EnvironmentAssignedTargetingOptionDetails) | [environment](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.EnvironmentAssignedTargetingOptionDetails.FIELDS.environment) | | [ExchangeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ExchangeAssignedTargetingOptionDetails) | [exchange](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ExchangeAssignedTargetingOptionDetails.FIELDS.exchange) | | [GenderAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.GenderAssignedTargetingOptionDetails) | [gender](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.GenderAssignedTargetingOptionDetails.FIELDS.gender) | | [HouseholdIncomeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.HouseholdIncomeAssignedTargetingOptionDetails) | [householdIncome](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.HouseholdIncomeAssignedTargetingOptionDetails.FIELDS.household_income) | | [NativeContentPositionAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.NativeContentPositionAssignedTargetingOptionDetails) | [contentPosition](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.NativeContentPositionAssignedTargetingOptionDetails.FIELDS.content_position) | | [OmidAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.OmidAssignedTargetingOptionDetails) | [omid](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.OmidAssignedTargetingOptionDetails.FIELDS.omid) | | [ParentalStatusAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ParentalStatusAssignedTargetingOptionDetails) | [parentalStatus](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ParentalStatusAssignedTargetingOptionDetails.FIELDS.parental_status) | | [SensitiveCategoryAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.SensitiveCategoryAssignedTargetingOptionDetails) | [excludedSensitiveCategory](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.SensitiveCategoryAssignedTargetingOptionDetails.FIELDS.excluded_sensitive_category) | | [VideoPlayerSizeAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.VideoPlayerSizeAssignedTargetingOptionDetails) | [videoPlayerSize](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.VideoPlayerSizeAssignedTargetingOptionDetails.FIELDS.video_player_size) | | [ViewabilityAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ViewabilityAssignedTargetingOptionDetails) | [viewability](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.ViewabilityAssignedTargetingOptionDetails.FIELDS.viewability) | - The following enum values have been added in v2: | Enum | Value(s) | |---|---| | [AgeRange](https://developers.google.com/display-video/api/reference/rest/v2/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](https://developers.google.com/display-video/api/reference/rest/v2/ContentRatingTier) | CONTENT_RATING_TIER_FAMILIES | | [Exchange](https://developers.google.com/display-video/api/reference/rest/v2/Exchange) | EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR | | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#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](https://developers.google.com/display-video/api/reference/rest/v2/ReservationType) | RESERVATION_TYPE_INSTANT_RESERVE RESERVATION_TYPE_PETRA_VIRAL | | [SensitiveCategory](https://developers.google.com/display-video/api/reference/rest/v2/SensitiveCategory) | SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO | - The following enum values have been removed in v2: | Enum | Value(s) | |---|---| | [LineItemFlightDateType](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#LineItemFlightDateType) | LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER | | [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v2/advertisers.lineItems#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 - The following enum values have been added in v1: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | EXCHANGE_DAX EXCHANGE_FYBER EXCHANGE_VISTAR | ## May 26, 2022 Added the ability to create [`InventorySource`](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource) resources and manage [`GuaranteedOrder`](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders#GuaranteedOrder) resources through new [`inventorySources`](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#methods) service write methods and a new [`guaranteedOrders`](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders#methods) service. Introduced the [`modelReadiness`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.model_readiness) field in the [`CustomBiddingAlgorithm`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm) resource. This field lists the readiness of the algorithm's model for each advertiser that can access it. Enabled new [`filter`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list#body.QUERY_PARAMETERS.filter) query parameter functionality for the [`advertisers.creatives.list`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list) method that allows the user to only retrieve creatives with an [`updateTime`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.update_time) before or after a given timestamp. Added support for the newest SDF version, [v5.5](https://developers.google.com/display-video/api/structured-data-file/v5-5/Campaign), through the addition of an [`SdfVersion`](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) enum value. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [guaranteedOrders](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders) | [create](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/create) [editGuaranteedOrderReadAccessors](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/editGuaranteedOrderReadAccessors) [get](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/guaranteedOrders/patch) | | [inventorySources](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources) | [create](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/create) [editInventorySourceReadWriteAccessors](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/editInventorySourceReadWriteAccessors) [patch](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/patch) | - The following fields have been added: | Resource | Field(s) | |---|---| | [CustomBiddingAlgorithm](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm) | [modelReadiness](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.model_readiness) | | [InventorySource](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource) | [inventorySourceProductType](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource.FIELDS.inventory_source_product_type) [guaranteedOrderId](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource.FIELDS.guaranteed_order_id) [readAdvertiserIds](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource.FIELDS.read_advertiser_ids) [readPartnerIds](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource.FIELDS.read_partner_ids) [readWriteAccessors](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources#InventorySource.FIELDS.read_write_accessors) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) | [SDF_VERSION_5_5](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion.ENUM_VALUES.SDF_VERSION_5_5) | - The following list methods are now filterable by the following properties: | Method | Field(s) | |---|---| | [advertisers.creatives.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list#body.QUERY_PARAMETERS.filter) | [updateTime](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.update_time) | ## March 31, 2022 Added support for retrieving and setting targeting on [content duration](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_DURATION), [stream type](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_STREAM_TYPE), and [genre](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_GENRE). Added the [`billableOutcome`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.billable_outcome) field to the `InsertionOrder` object. Introduced the [`raiseBidForDeals`](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.raise_bid_for_deals) field to the `MaximizeSpendBidStrategy` object, letting users set whether the bidding strategy applies advertiser floor prices for targeted deals. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [contentDurationDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.content_duration_details) [contentGenreDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.content_genre_details) [contentStreamTypeDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.content_stream_type_details) | | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder) | [billableOutcome](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.billable_outcome) | | [MaximizeSpendBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy) | [raiseBidForDeals](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.raise_bid_for_deals) | | [TargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption) | [contentDurationDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.content_duration_details) [contentGenreDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.content_genre_details) [contentStreamTypeDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.content_stream_type_details) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType) | [TARGETING_TYPE_CONTENT_DURATION](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_DURATION) [TARGETING_TYPE_CONTENT_GENRE](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_GENRE) [TARGETING_TYPE_CONTENT_STREAM_TYPE](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CONTENT_STREAM_TYPE) | ## February 2, 2022 Added support for [creating](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/create), [updating](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/patch), and [editing members of](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/editCustomerMatchMembers) certain Customer Match [`FirstAndThirdPartyAudience`](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences) resources. The [Upload Customer Match Audiences](https://developers.google.com/display-video/api/guides/audiences/upload-customer-match) page in our new [Use Audiences](https://developers.google.com/display-video/api/guides/audiences/overview) guide details how to use these new features. Introduced a new `reservationType` field in [`InsertionOrder`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.reservation_type) and [`LineItem`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.reservation_type) resources that identifies whether a resource is Tag Guaranteed, Programmatic Guaranteed, or not guaranteed. Added the ability to retrieve and set whether a line item automatically targets new exchanges through a new [`excludeNewExchanges`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.exclude_new_exchanges) field. In addition to new features, default [quota limits](https://developers.google.com/display-video/api/limits) have been doubled. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [firstAndThirdPartyAudiences](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences) | [create](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/create) [editCustomerMatchMembers](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/editCustomerMatchMembers) [patch](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/patch) | - The following fields have been added: | Resource | Field(s) | |---|---| | [FirstAndThirdPartyAudience](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience) | [appId](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.app_id) [contactInfoList](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.contact_info_list) [mobileDeviceIdList](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.mobile_device_id_list) | | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder) | [reservationType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.reservation_type) | | [LineItem](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem) | [excludeNewExchanges](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.exclude_new_exchanges) [reservationType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.reservation_type) | ## December 8, 2021 Added support for audio content type targeting under the targeting type [`TARGETING_TYPE_AUDIO_CONTENT_TYPE`](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_AUDIO_CONTENT_TYPE). ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [audioContentTypeDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.audio_content_type_details) | | [TargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption) | [audioContentTypeDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.audio_content_type_details) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType) | [TARGETING_TYPE_AUDIO_CONTENT_TYPE](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_AUDIO_CONTENT_TYPE) | ## November 8, 2021 Added full support for managing custom bidding algorithms and their scripts. This includes: - Functions to [create](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/create) new and [update](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/patch) existing [`customBiddingAlgorithms`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm). - The ability to upload scripts through the process of [retrieving an available resource location](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/uploadScript) and then [uploading the file](https://developers.google.com/display-video/api/reference/rest/v1/media/upload) to that location. - A new [`customBiddingAlgorithms.scripts`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts) service to [retrieve](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/list) and [create](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/create) [`customBiddingScripts`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts#CustomBiddingScript). A new [Implement Custom Bidding](https://developers.google.com/display-video/api/guides/managing-line-items/custom-bidding) page has been added to our [Managing Line Items](https://developers.google.com/display-video/api/guides/managing-line-items/overview) guide that describes the process of creating a custom bidding algorithm, uploading a script, and assigning the custom bidding algorithm to be as a line item's bidding strategy. Added support for the newest SDF version, [v5.4](https://developers.google.com/display-video/api/structured-data-file/v5-4/Campaign), through the addition of an [`SdfVersion`](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) enum value. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [customBiddingAlgorithms](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms) | [create](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/create) [patch](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/patch) [uploadScript](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/uploadScript) | | [customBiddingAlgorithms.scripts](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts) | [create](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/create) [get](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms.scripts/list) | | [media](https://developers.google.com/display-video/api/reference/rest/v1/media) | [upload](https://developers.google.com/display-video/api/reference/rest/v1/media/upload) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) | [SDF_VERSION_5_4](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion.ENUM_VALUES.SDF_VERSION_5_4) | ## September 14, 2021 Added support for proximity targeting under targeting types [`TARGETING_TYPE_BUSINESS_CHAIN`](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_BUSINESS_CHAIN) and [`TARGETING_TYPE_POI`](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_POI). Added the ability to search for available [`TARGETING_TYPE_BUSINESS_CHAIN`](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search#body.request_body.FIELDS.business_chain_search_terms) and [`TARGETING_TYPE_POI`](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search#body.request_body.FIELDS.poi_search_terms) targeting options using [`targetingTypes.targetingOptions.search`](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search), as they cannot be retrieved via [`targetingTypes.targetingOptions.get`](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/get) or [`targetingTypes.targetingOptions.list`](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/list) methods. Introduced new [`sharedAdvertiserIds`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.shared_advertiser_ids) and [`customBiddingAlgorithmState`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.custom_bidding_algorithm_state) fields to the Custom Bidding Algorithm resource and added support for the [`GOAL_BUILDER_BASED`](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithmType.ENUM_VALUES.GOAL_BUILDER_BASED) custom bidding algorithm type. Added a two new values to the [`Exchange`](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) enum. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [businessChainDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.business_chain_details) [poiDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.poi_details) | | [CustomBiddingAlgorithm](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm) | [customBiddingAlgorithmState](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.custom_bidding_algorithm_state) [sharedAdvertiserIds](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.shared_advertiser_ids) | | [TargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption) | [businessChainDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.business_chain_details) [poiDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.poi_details) | | [TargetingOptions.search Request Body](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search#request-body) | [businessChainSearchTerms](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search#body.request_body.FIELDS.business_chain_search_terms) [poiSearchTerms](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search#body.request_body.FIELDS.poi_search_terms) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [CustomBiddingAlgorithmType](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithmType) | [GOAL_BUILDER_BASED](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithmType.ENUM_VALUES.GOAL_BUILDER_BASED) | | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | [EXCHANGE_RED_FOR_PUBLISHERS](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_RED_FOR_PUBLISHERS) [EXCHANGE_TAPJOY](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_TAPJOY) | | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType) | [TARGETING_TYPE_BUSINESS_CHAIN](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_BUSINESS_CHAIN) [TARGETING_TYPE_POI](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_POI) | - The following list methods are now filterable by the following properties: | Method | Field(s) | |---|---| | [customBiddingAlgorithms.list](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/list#body.QUERY_PARAMETERS.filter) | [customBiddingAlgorithmState](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms#CustomBiddingAlgorithm.FIELDS.custom_bidding_algorithm_state) | ## August 4, 2021 Added support for [Open Measurement enabled inventory targeting](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.omid_details) under the targeting type [`TARGETING_TYPE_OMID`](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_OMID). Increased the maximum number of assigned targeting options that can be returned in a single page of various [advertiser](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/list), [campaign](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions/list), [insertion order](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/list), and [line item](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/list) assigned targeting option list methods using the `pageSize` method parameter. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [omidDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.omid_details) | | [TargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption) | [omidDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.omid_details) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType) | [TARGETING_TYPE_OMID](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_OMID) | - The max page size has been increased for the following list methods: | Method | New Max Page Size | |---|---| | [advertisers.campaigns.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions/list#body.QUERY_PARAMETERS.page_size) | 5000 | | [advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/list#body.QUERY_PARAMETERS.page_size) | 5000 | | [advertisers.lineItems.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/list#body.QUERY_PARAMETERS.page_size) | 5000 | | [advertisers.targetingTypes.assignedTargetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/list#body.QUERY_PARAMETERS.page_size) | 5000 | ## May 26, 2021 Launched the [`advertisers.invoices`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.invoices) service, which lets users: - retrieve invoices issued to an advertiser during a given month. - lookup the currency code used by an advertiser during a given month. Added the [`campaignBudgets`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign.FIELDS.campaign_budgets) field to the campaign resource. [Insertion order budget segments](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrderBudgetSegment) can be linked to a [campaign budget](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#CampaignBudget), restricting the sum budget of the associated segments to the total campaign budget amount. Added support for [native content position targeting](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.native_content_position_details) under the new targeting type [`TARGETING_TYPE_NATIVE_CONTENT_POSITION`](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_NATIVE_CONTENT_POSITION). Introduced a new [`prismaEnabled`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.prisma_enabled) field to the advertiser resource, letting users enable integration with Mediaocean's Prisma tool. Enabled support for the [`ENTITY_STATUS_PAUSED`](https://developers.google.com/display-video/api/reference/rest/v1/EntityStatus#ENUM_VALUES.ENTITY_STATUS_PAUSED) enum value to the Advertiser's [`entityStatus`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.entity_status) field. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.invoices](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.invoices) | [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.invoices/list) [lookupInvoiceCurrency](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.invoices/lookupInvoiceCurrency) | - The following fields have been added: | Resource | Field(s) | |---|---| | [Advertiser](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser) | [prismaEnabled](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.prisma_enabled) | | [AssignedTargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) | [nativeContentPositionDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.FIELDS.native_content_position_details) | | [Campaign](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign) | [campaignBudgets](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign.FIELDS.campaign_budgets) | | [TargetingOption](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption) | [nativeContentPositionDetails](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.native_content_position_details) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [AssignedTargetingOption.Recency](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Recency) | [RECENCY_45_DAYS](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.Recency.ENUM_VALUES.RECENCY_45_DAYS) | | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | [EXCHANGE_MEDIANET](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_MEDIANET) | | [TargetingType](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType) | [TARGETING_TYPE_NATIVE_CONTENT_POSITION](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_NATIVE_CONTENT_POSITION) | - The following enum values are now valid for the following fields: | Resource | Field | Value(s) | |---|---|---| | [Advertiser](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser) | [entityStatus](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.entity_status) | [ENTITY_STATUS_PAUSED](https://developers.google.com/display-video/api/reference/rest/v1/EntityStatus#ENUM_VALUES.ENTITY_STATUS_PAUSED) | ## April 29, 2021 Added new fields to [Channel](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels#Channel) and [Negative Keyword List](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists#NegativeKeywordList) resources that return the count of line items using the resource for targeting. Enabled new [`filter`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) properties for the [line item list method](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list) that allow the user to only retrieve line items that are using specific channels or negative keyword lists in their targeting. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [Channel](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels#Channel) | [negativelyTargetedLineItemCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels#Channel.FIELDS.negatively_targeted_line_item_count) [positivelyTargetedLineItemCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels#Channel.FIELDS.positively_targeted_line_item_count) | | [NegativeKeywordList](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists#NegativeKeywordList) | [targetedLineItemCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists#NegativeKeywordList.FIELDS.targeted_line_item_count) | - The following list methods are now filterable by the following properties: | Method | Field(s) | |---|---| | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | targetedChannelId targetedNegativeKeywordListId | ## March 30, 2021 Added a [new method to the line item service](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/generateDefault) that generates a line item with default configurations. These default values are based on the given [line item type](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType), as well as the settings and assigned targeting of the parent insertion order. Enabled the retrieval of campaign targeting through a [new campaign targeting service](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions) and [additional bulk list method](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/bulkListCampaignAssignedTargetingOptions). Expanded [app targeting](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppAssignedTargetingOptionDetails) to allow the targeting of apps on [more platforms](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppPlatform). Made multiple changes to [`advertisers.channels.sites`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites), [`partners.channels.sites`](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites) and [`advertisers.negativeKeywordLists.negativeKeywords`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords) services to allow for easier management of channel and negative keyword list content. These changes include: - The addition of `replace` methods, which enables a user to fully overwrite the existing contents of a channel or negative keyword list. - The removal of the requirement that no existing items be included in the [`createdSites`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/bulkEdit#body.request_body.FIELDS.created_sites) or [`createdNegativeKeywords`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/bulkEdit#body.request_body.FIELDS.created_negative_keywords) fields of bulk edit requests. - The increase of the maximum number of items that can be returned on a single page of a [list sites](https://developers.google.com/display-video/api/reference/rest/v1/ListSitesResponse) or [list negative keywords](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/list#response-body) response. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.campaigns](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns) | [bulkListCampaignAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/bulkListCampaignAssignedTargetingOptions) | | [advertisers.campaigns.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions) | [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions/list) | | [advertisers.channels.sites](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites) | [replace](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/replace) | | [advertisers.lineItems](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems) | [generateDefault](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/generateDefault) | | [advertisers.negativeKeywordLists.negativeKeywords](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords) | [replace](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/replace) | | [partners.channels.sites](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites) | [replace](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/replace) | - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption.AppAssignedTargetingOptionDetails](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppAssignedTargetingOptionDetails) | [appPlatform](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AppAssignedTargetingOptionDetails.FIELDS.app_platform) | - The max page size has been increased for the following list methods: | Method | Old Max Page Size | New Max Page Size | |---|---|---| | [advertisers.channels.sites.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/list#body.QUERY_PARAMETERS.page_size) | 100 | 10000 | | [advertisers.negativeKeywordLists.negativeKeywords.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/list#body.QUERY_PARAMETERS.page_size) | 100 | 1000 | | [partners.channels.sites.list](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/list#body.QUERY_PARAMETERS.page_size) | 100 | 10000 | ### Deprecations - The following enum values can no longer be assigned to new or existing resources: | Enum | Value(s) | |---|---| | [PartnerRevenueModelMarkupType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModelMarkupType) | [PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#PartnerRevenueModelMarkupType.ENUM_VALUES.PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP) | ## February 24, 2021 Introduced a [new insertion order targeting service](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions) and [additional bulk list method](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/bulkListInsertionOrderAssignedTargetingOptions) enabling the retrieval of targeting assigned to insertion orders. Expanded the creative resource, adding [output-only creative fields](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.mp3_audio) for use by third-party audio creatives. Added [new performance goal types](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_CLICK_CVR) for use by [insertion order](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.performance_goal) and [campaign](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#CampaignGoal.FIELDS.performance_goal) resources. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers.insertionOrders](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders) | [bulkListInsertionOrderAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/bulkListInsertionOrderAssignedTargetingOptions) | | [advertisers.insertionOrders.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions) | [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders.targetingTypes.assignedTargetingOptions/list) | - The following fields have been added: | Resource | Field(s) | |---|---| | [Creative](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative) | [mp3Audio](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.mp3_audio) [oggAudio](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.ogg_audio) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [ContentInstreamPosition](https://developers.google.com/display-video/api/reference/rest/v1/ContentInstreamPosition) | [CONTENT_INSTREAM_POSITION_UNKNOWN](https://developers.google.com/display-video/api/reference/rest/v1/ContentInstreamPosition#ENUM_VALUES.CONTENT_INSTREAM_POSITION_UNKNOWN) | | [PerformanceGoalType](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType) | [PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE) [PERFORMANCE_GOAL_TYPE_CLICK_CVR](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_CLICK_CVR) [PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR) [PERFORMANCE_GOAL_TYPE_VCPM](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_VCPM) [PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE) [PERFORMANCE_GOAL_TYPE_VTR](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_VTR) | ## January 27, 2021 Enabled retrieval and management of TV insertion orders and over-the-top line items through the introduction of a [new InsertionOrderType field](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.insertion_order_type) and a [new LineItemType enum value](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP). Added support for mobile app line items through a [`mobileApp`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.mobile_app) line item field. Expanded [exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange), [google audience](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences#GoogleAudienceType), and [SDF](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) support through additional enum values. Introduced the capability to filter and order [`advertisers.list`](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/list) values by the [last updated time](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.update_time). ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [InsertionOrder](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder) | [insertionOrderType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.insertion_order_type) | | [LineItem](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem) | [mobileApp](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.mobile_app) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | [EXCHANGE_SHARETHROUGH](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_SHARETHROUGH) [EXCHANGE_SOUNDCAST](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_SOUNDCAST) | | [GoogleAudienceType](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences#GoogleAudienceType) | [GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences#GoogleAudienceType.ENUM_VALUES.GOOGLE_AUDIENCE_TYPE_EXTENDED_DEMOGRAPHIC) [GOOGLE_AUDIENCE_TYPE_LIFE_EVENT](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences#GoogleAudienceType.ENUM_VALUES.GOOGLE_AUDIENCE_TYPE_LIFE_EVENT) | | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType) | [LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP) | | [SdfVersion](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion) | [SDF_VERSION_5_3](https://developers.google.com/display-video/api/reference/rest/v1/SdfConfig#SdfVersion.ENUM_VALUES.SDF_VERSION_5_3) | - The following list methods are now able to be ordered and filtered by the following fields: | Method | Field(s) | |---|---| | [advertisers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/list#body.QUERY_PARAMETERS.filter) | [updateTime](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.update_time) | ## December 4, 2020 Added the capability to [search](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search) for [Geo Region](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_GEO_REGION) targeting options and filter multiple resource list method results by their last updated time. Introduced a [new LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage.ENUM_VALUES.TARGETING_DEPRECATED_GEO_TARGET) to inform users of when a line item is using deprecated geographic targeting. ### New Features - The following methods have been added: | Service | Method(s) | |---|---| | [targetingTypes.targetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions) | [search](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/search) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | [EXCHANGE_SUPERSHIP](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_SUPERSHIP) | | [LineItemWarningMessage](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#lineitemwarningmessage) | [TARGETING_DEPRECATED_GEO_TARGET](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage.ENUM_VALUES.TARGETING_DEPRECATED_GEO_TARGET) | - The following list methods are now able to be ordered and filtered by the following fields: | Method | Field(s) | |---|---| | [advertisers.campaigns.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/list#body.QUERY_PARAMETERS.filter) | [updateTime](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign.FIELDS.update_time) | | [advertisers.insertionOrders.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/list#body.QUERY_PARAMETERS.filter) | [updateTime](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.update_time) | | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | [updateTime](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.update_time) | ## November 5, 2020 Added the capability to create, assign and activate [manual triggers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers) that initiate associated line items' spending. Introduced [targeting expansion options](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#TargetingExpansionConfig) that, when set, can expand the targeting of a line item to include users similar to those in targeted audiences. Appended custom segment ID fields to [DoubleVerify](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#doubleverify) and [Integral Ad Science](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#integraladscience) objects used in [third-party verification targeting](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#thirdpartyverifierassignedtargetingoptiondetails). ### New Features - The following services have been added: | Service | Method(s) | |---|---| | [advertisers.manualTriggers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers) | [activate](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/activate) [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/create) [deactivate](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/deactivate) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.manualTriggers/patch) | - The following fields have been added: | Resource | Field(s) | |---|---| | [AssignedTargetingOption.DoubleVerify](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DoubleVerify) | [customSegmentId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.DoubleVerify.FIELDS.custom_segment_id) | | [AssignedTargetingOption.IntegralAdScience](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.IntegralAdScience) | [customSegmentId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.IntegralAdScience.FIELDS.custom_segment_id) | | [LineItem](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem) | [targetingExpansion](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.targeting_expansion) | | [LineItemFlight](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight) | [triggerId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight.FIELDS.trigger_id) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [LineItemFlightDateType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlightDateType) | [LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlightDateType.ENUM_VALUES.LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER) | - The following list methods are now filterable by the following fields: | Method | Field(s) | |---|---| | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | [filter.triggerId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemFlight.FIELDS.trigger_id) | ## October 12, 2020 Introduced retrievable [warning messages](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemWarningMessage) to the line item resource and a click-through rate (CTR) performance goal type. Added `warningMessages` as a filterable field when listing line items. In addition to new features, [new quota limits](https://developers.google.com/display-video/api/limits) are now in effect and new documentation on [utilizing batch requests](https://developers.google.com/display-video/api/guides/how-tos/batch) is available. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [LineItem](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems) | [warningMessages](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.warning_messages) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [PerformanceGoalType](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType) | [PERFORMANCE_GOAL_TYPE_CTR](https://developers.google.com/display-video/api/reference/rest/v1/PerformanceGoal#PerformanceGoalType.ENUM_VALUES.PERFORMANCE_GOAL_TYPE_CTR) | - The following list methods are now filterable by the following fields: | Method | Field(s) | |---|---| | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | [warningMessages](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.warning_messages) | ## August 28, 2020 Added new fields to the response of the [advertiser audit method](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit) and new filterable fields to various list methods. ### New Features - The following fields have been added: | Resource | Field(s) | |---|---| | [Advertisers.Audit Response Body](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#response-body) | [adGroupCriteriaCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#body.AuditAdvertiserResponse.FIELDS.ad_group_criteria_count) [campaignCriteriaCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#body.AuditAdvertiserResponse.FIELDS.campaign_criteria_count) [channelsCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#body.AuditAdvertiserResponse.FIELDS.channels_count) [negativeKeywordListsCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#body.AuditAdvertiserResponse.FIELDS.negative_keyword_lists_count) [negativelyTargetedChannelsCount](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit#body.AuditAdvertiserResponse.FIELDS.negatively_targeted_channels_count) | - The following list methods are now filterable by the following fields: | Method | Field(s) | |---|---| | [advertisers.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/list#body.QUERY_PARAMETERS.filter) | [advertiserId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.advertiser_id) [displayName](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.display_name) | | [advertisers.campaigns.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/list#body.QUERY_PARAMETERS.filter) | [campaignId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign.FIELDS.campaign_id) [displayName](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns#Campaign.FIELDS.display_name) | | [advertisers.insertionOrders.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/list#body.QUERY_PARAMETERS.filter) | [budget.budget_segments.date_range.end_date](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.budget) [displayName](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.display_name) | | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | [displayName](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.display_name) [lineItemId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.line_item_id) | | [targetingTypes.targetingOptions.list](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/list#body.QUERY_PARAMETERS.filter) | [carrierAndIspDetails.type](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.carrier_and_isp_details) [geoRegionDetails.geo_region_type](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions#TargetingOption.FIELDS.geo_region_details) | ## August 4, 2020 Launched new [user management](https://developers.google.com/display-video/api/reference/rest/v1/users), [partner](https://developers.google.com/display-video/api/reference/rest/v1/partners), and [partner targeting services](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions). Introduced tools to help users proactively avoid reaching [account entity limits](https://support.google.com/displayvideo/answer/6071450). Added support for [audio line items](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_AUDIO_DEFAULT) and the use of [custom bidding algorithms](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms) in [line items](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.bid_strategy) and [insertion order](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrder.FIELDS.bid_strategy) bid strategies. ### New Features - The following services have been added: | Service | Method(s) | |---|---| | [customBiddingAlgorithms](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms) | [get](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/customBiddingAlgorithms/list) | | [partners](https://developers.google.com/display-video/api/reference/rest/v1/partners) | [bulkEditPartnerAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/partners/bulkEditPartnerAssignedTargetingOptions) [get](https://developers.google.com/display-video/api/reference/rest/v1/partners/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/partners/list) | | [partners.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions) | [create](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/partners.targetingTypes.assignedTargetingOptions/list) | | [users](https://developers.google.com/display-video/api/reference/rest/v1/users) | [bulkEditAssignedUserRoles](https://developers.google.com/display-video/api/reference/rest/v1/users/bulkEditAssignedUserRoles) [create](https://developers.google.com/display-video/api/reference/rest/v1/users/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/users/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/users/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/users/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/users/patch) | - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers) | [audit](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/audit) | - The following fields have been added: | Resource | Field(s) | |---|---| | [MaximizeSpendBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy) | [customBiddingAlgorithmId](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#MaximizeSpendBidStrategy.FIELDS.custom_bidding_algorithm_id) | | [PerformanceGoalBidStrategy](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy) | [customBiddingAlgorithmId](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#PerformanceGoalBidStrategy.FIELDS.custom_bidding_algorithm_id) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [BiddingStrategyPerformanceGoalType](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#biddingstrategyperformancegoaltype) | [BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO](https://developers.google.com/display-video/api/reference/rest/v1/BiddingStrategy#BiddingStrategyPerformanceGoalType.ENUM_VALUES.BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO) | | [LineItemType](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#lineitemtype) | [LINE_ITEM_TYPE_AUDIO_DEFAULT](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_AUDIO_DEFAULT) | - The following list methods are now able to be ordered and filtered by the following fields: | Method | Field(s) | |---|---| | [advertisers.lineItems.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list#body.QUERY_PARAMETERS.filter) | [flight.dateRange.endDate](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems#LineItem.FIELDS.flight) | - The following scopes have been added to use for the following services: | Scope | Service(s) | |---|---| | https://www.googleapis.com/auth/display-video-user-management | [users](https://developers.google.com/display-video/api/reference/rest/v1/users) | ## June 24, 2020 Launched a small update adding a create method for [partner](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels) and [advertiser](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels) channels, new [FirstAndThirdPartyAudience](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences) fields, and additional [exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) enum values. ### New Features - The following services have been added: | Service | Method(s) | |---|---| | [advertisers.channels](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels/create) | | [partners.channels](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels) | [create](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels/create) | - The following fields have been added: | Resource | Field(s) | |---|---| | [FirstAndThirdPartyAudience](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences) | [activeDisplayAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.active_display_audience_size) [audienceSource](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.audience_source) [audienceType](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.audience_type) [description](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.description) [displayAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.display_audience_size) [displayDesktopAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.display_desktop_audience_size) [displayMobileAppAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.display_mobile_app_audience_size) [displayMobileWebAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.display_mobile_web_audience_size) [gmailAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.gmail_audience_size) [membershipDurationDays](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.membership_duration_days) [youtubeAudienceSize](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences#FirstAndThirdPartyAudience.FIELDS.youtube_audience_size) | - The following enum values have been added: | Enum | Value(s) | |---|---| | [Exchange](https://developers.google.com/display-video/api/reference/rest/v1/Exchange) | [EXCHANGE_OPEN8](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_OPEN8) [EXCHANGE_TRITON](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_TRITON) [EXCHANGE_UNRULYX](https://developers.google.com/display-video/api/reference/rest/v1/Exchange#ENUM_VALUES.EXCHANGE_UNRULYX) | - The following list methods are now filterable by the following fields: | Method | Field(s) | |---|---| | [advertisers.creatives.list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list#body.QUERY_PARAMETERS.filter) | [creativeId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.creative_id) | ## June 02, 2020 Introduced the ability to create, patch, and populate a subset of targetable entities and added the ability to modify advertiser-level targeting for three [targeting types](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType): [channel](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_CHANNEL), [digital content label exclusion](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION), and [sensitive category exclusion](https://developers.google.com/display-video/api/reference/rest/v1/TargetingType#ENUM_VALUES.TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION). ### New Features - The following services have been added: | Service | Method(s) | |---|---| | [advertisers.channels.sites](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites) | [bulkEdit](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/bulkEdit) [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/delete) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels.sites/list) | | [advertisers.locationLists.assignedLocations](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations) | [bulkEdit](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations/bulkEdit) [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations/delete) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists.assignedLocations/list) | | [advertisers.negativeKeywordLists.negativeKeywords](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords) | [bulkEdit](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/bulkEdit) [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/delete) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists.negativeKeywords/list) | | [advertisers.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.targetingTypes.assignedTargetingOptions/list) | | [inventorySourceGroups.assignedInventorySources](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups.assignedInventorySources) | [bulkEdit](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups.assignedInventorySources/bulkEdit) [create](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups.assignedInventorySources/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups.assignedInventorySources/delete) [list](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups.assignedInventorySources/list) | | [partners.channels.sites](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites) | [bulkEdit](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/bulkEdit) [create](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/delete) [list](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels.sites/list) | - The following methods have been added: | Service | Method(s) | |---|---| | [advertisers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers) | [bulkEditAdvertiserAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/bulkEditAdvertiserAssignedTargetingOptions) [bulkListAdvertiserAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/bulkListAdvertiserAssignedTargetingOptions) | | [advertisers.channels](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels) | [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels/patch) | | [advertisers.locationLists](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists/create) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists/patch) | | [advertisers.negativeKeywordLists](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/delete) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/patch) | | [inventorySourceGroups](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups) | [create](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/delete) [patch](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/patch) | | [partners.channels](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels) | [patch](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels/patch) | - The following fields have been added: | Resource | Field(s) | |---|---| | [advertiser](https://developers.google.com/display-video/api/reference/rest/v1/advertisers) | [servingConfig](https://developers.google.com/display-video/api/reference/rest/v1/advertisers#Advertiser.FIELDS.serving_config) | | [creative](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives) | [lineItemIds](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives#Creative.FIELDS.line_item_ids) | | [insertionOrder.insertionOrderBudgetSegment](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#insertionorderbudgetsegment) | [campaignBudgetId](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders#InsertionOrderBudgetSegment.FIELDS.campaign_budget_id) | ## April 27, 2020 Launched a large feature set, expanding the scope of the API beyond SDF. Added core resource management that allows you to create, retrieve, update, and delete entities such as advertisers, campaigns, insertion orders, line items and creatives. New capabilities also allow the editing of targeting at the line item level. ### New Features The following services have been added: | Service | Method(s) | |---|---| | [advertisers](https://developers.google.com/display-video/api/reference/rest/v1/advertisers) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers/patch) | | [advertisers.assets](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.assets) | [upload](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.assets/upload) | | [advertisers.campaigns](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.campaigns/patch) | | [advertisers.channels](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels) | [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.channels/list) | | [advertisers.creatives](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.creatives/patch) | | [advertisers.insertionOrders](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.insertionOrders/patch) | | [advertisers.lineItems](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems) | [bulkEditLineItemAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/bulkEditLineItemAssignedTargetingOptions) [bulkListLineItemAssignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/bulkListLineItemAssignedTargetingOptions) [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/list) [patch](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems/patch) | | [advertisers.lineItems.targetingTypes.assignedTargetingOptions](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions) | [create](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/create) [delete](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/delete) [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.lineItems.targetingTypes.assignedTargetingOptions/list) | | [advertisers.locationLists](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists) | [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.locationLists/list) | | [advertisers.negativeKeywordLists](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists) | [get](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/advertisers.negativeKeywordLists/list) | | [combinedAudiences](https://developers.google.com/display-video/api/reference/rest/v1/combinedAudiences) | [get](https://developers.google.com/display-video/api/reference/rest/v1/combinedAudiences/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/combinedAudiences/list) | | [customLists](https://developers.google.com/display-video/api/reference/rest/v1/customLists) | [get](https://developers.google.com/display-video/api/reference/rest/v1/customLists/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/customLists/list) | | [firstAndThirdPartyAudiences](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences) | [get](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/firstAndThirdPartyAudiences/list) | | [floodlightGroups](https://developers.google.com/display-video/api/reference/rest/v1/floodlightGroups) | [get](https://developers.google.com/display-video/api/reference/rest/v1/floodlightGroups/get) [patch](https://developers.google.com/display-video/api/reference/rest/v1/floodlightGroups/patch) | | [googleAudiences](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences) | [get](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/googleAudiences/list) | | [inventorySourceGroups](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups) | [get](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/inventorySourceGroups/list) | | [inventorySources](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources) | [get](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/inventorySources/list) | | [partners.channels](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels) | [get](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/partners.channels/list) | | [partners.channels](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions) | [get](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/get) [list](https://developers.google.com/display-video/api/reference/rest/v1/targetingTypes.targetingOptions/list) | ## March 09, 2020 Launched Display \& Video 360 API v1. This is the initial version of the API. ### Known issues None.