# Release Notes

This page provides release notes for the Display \& Video 360 API v1beta2.

## June 10, 2022

Added support for managing Commerce line items as specified by the
`LineItemType` [`LINE_ITEM_TYPE_DISPLAY_COMMERCE`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_DISPLAY_COMMERCE).

In addition to this added feature, the available `v1beta2` reference
documentation has been updated to include all features currently available in
`v1`, up to and including our [May 2022 update](https://developers.google.com/display-video/api/release-notes#may_26_2022). These
features are all available in `v1beta2` and are accessible by the using the
[Python client library](https://developers.google.com/display-video/api/v1beta2/faq#i_want_to_write_code_where_can_i_find_client_libraries).

### New Features Exclusive to `v1beta2`

- The following enum values have been added:

  | Enum | Value(s) |
  |---|---|
  | [LineItemType](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/advertisers.lineItems#LineItemType) | [LINE_ITEM_TYPE_DISPLAY_COMMERCE](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/advertisers.lineItems#LineItemType.ENUM_VALUES.LINE_ITEM_TYPE_DISPLAY_COMMERCE) |

## September 15, 2021

Enabled custom bidding algorithm management through additions to
[`CustomBiddingAlgorithm`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms) and [`CustomBiddingAlgorithm.scripts`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts)
services. The additional features include:

- [`customBiddingAlgorithms.create`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms/create) method
- [`customBiddingAlgorithms.uploadScript`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms/uploadScript) method, which enables users to retrieve a valid resource location to which they can upload scripts
- [`media.upload`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/media/upload) method, with which users can upload a script file
- [`customBiddingAlgorithms.scripts.create`](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts/create) method

In addition to these added features, the available `v1beta2` reference
documentation has been updated to include all features currently available in
`v1`, up to and including our [September 2021 update](https://developers.google.com/display-video/api/release-notes#september_14_2021). These
features are all available in `v1beta2` and are accessible by the using the
[Python client library](https://developers.google.com/display-video/api/v1beta2/faq#i_want_to_write_code_where_can_i_find_client_libraries).

### New Features Exclusive to `v1beta2`

- The following methods have been added:

  | Service | Method(s) |
  |---|---|
  | [customBiddingAlgorithms](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms) | [create](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms/create) [patch](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms/patch) [uploadScript](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms/uploadScript) |
  | [customBiddingAlgorithms.scripts](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts) | [create](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts/create) [get](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts/get) [list](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/customBiddingAlgorithms.scripts/list) |
  | [media](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/media) | [upload](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/media/upload) |

## September 15, 2020

Added new write methods to the inventory source service. Also included new
features added in the [August 28th v1 update](https://developers.google.com/display-video/api/release-notes#august_28_2020).

### New Features

#### Exclusive to v1beta2

- The following methods have been added:

  | Service | Method(s) |
  |---|---|
  | [inventorySources](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources) | [create](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources/create) [editInventorySourceReadWriteAccessors](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources/editInventorySourceReadWriteAccessors) [patch](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources/patch) |

#### Included in recent v1 update

- 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 10, 2020

Launched Display \& Video 360 API v1beta2. It has all the existing features
of Display \& Video 360 API v1, with the addition of a new deals management beta feature.

### New Features

- The following services have been added:

  | Service | Method(s) |
  |---|---|
  | [guaranteedOrders](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders) | [create](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders/create) [editGuaranteedOrderReadAccessors](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders/editGuaranteedOrderReadAccessors) [get](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders/get) [list](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders/list) [patch](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/guaranteedOrders/patch) |

- The following fields have been added:

  | Resource | Field(s) |
  |---|---|
  | [InventorySource](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources) | [guaranteedOrderId](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources#InventorySource.FIELDS.guaranteed_order_id) [readAdvertiserIds](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources#InventorySource.FIELDS.read_advertiser_ids) [readPartnerIds](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources#InventorySource.FIELDS.read_partner_ids) [readWriteAccessors](https://developers.google.com/display-video/api/v1beta2/reference/rest/v1beta2/inventorySources#InventorySource.FIELDS.read_write_accessors) |