Deprecations
Stay organized with collections
Save and categorize content based on your preferences.
Fields in the BidRequest or BidResponse can occasionally be deprecated.
Deprecated fields eventually sunset, meaning they'll be removed from the
protocol and will no longer work.
The notification period is the amount of time between deprecation and sunset.
During the notification period, update your code to remove any dependencies
on deprecated fields to ensure uninterrupted service.
Deprecated fields have a [deprecated = true] option, and the following
statement in the first line of their descriptions:
Deprecated. This will be removed in {MONTH} {YEAR}
You might also encounter deprecated field names with a DEPRECATED_ prefix,
which is the legacy way of marking deprecated fields.
Deprecations and sunsets are announced in the release
notes and
blog.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-18 UTC.
[null,null,["Last updated 2025-08-18 UTC."],[[["\u003cp\u003eFields in BidRequest and BidResponse can be deprecated and eventually removed (sunsetted).\u003c/p\u003e\n"],["\u003cp\u003eYou'll be notified before a field is removed, giving you time to update your code.\u003c/p\u003e\n"],["\u003cp\u003eDeprecated fields are marked with \u003ccode\u003e[deprecated = true]\u003c/code\u003e or a \u003ccode\u003eDEPRECATED_\u003c/code\u003e prefix in their description.\u003c/p\u003e\n"],["\u003cp\u003eRefer to release notes and the Ads Developer Blog for deprecation and sunset announcements.\u003c/p\u003e\n"]]],["Deprecated fields in `BidRequest` or `BidResponse` will eventually be removed. During the notification period before removal, update code to remove dependencies on these fields. Deprecated fields are marked with `[deprecated = true]` and a removal date in their description, or a `DEPRECATED_` prefix. Deprecations and sunsets are announced in release notes and the blog. Ensure continuous service by updating your code.\n"],null,["# Deprecations\n\nFields in the `BidRequest` or `BidResponse` can occasionally be deprecated.\nDeprecated fields eventually sunset, meaning they'll be removed from the\nprotocol and will no longer work.\n\nThe notification period is the amount of time between deprecation and sunset.\n**During the notification period, update your code to remove any dependencies\non deprecated fields** to ensure uninterrupted service.\n\nDeprecated fields have a `[deprecated = true]` option, and the following\nstatement in the first line of their descriptions: \n\n```\nDeprecated. This will be removed in {MONTH} {YEAR}\n```\n\nYou might also encounter deprecated field names with a `DEPRECATED_` prefix,\nwhich is the legacy way of marking deprecated fields.\n\nDeprecations and sunsets are announced in the [release\nnotes](/authorized-buyers/rtb/relnotes) and\n[blog](//ads-developers.googleblog.com/search/label/ad_exchange)."]]
