Stay organized with collections
Save and categorize content based on your preferences.
Periodically, you might want to upgrade from an older major version of the
Google Ads API to a newer major version. It could be because a version is sunsetting,
or it could be because you want to use a new feature. We recommend that you
always upgrade to the newest version.
The error when your request is throttled because it is too expensive will
be either
QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION or
QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION instead
of QuotaError.RESOURCE_EXHAUSTED. See the blog
post for more details.
Campaigns with an AdvertisingChannelType of
DISCOVERY will now have an AdvertisingChannelType of
DEMAND_GEN instead.
Additionally, some ads will change type and field names for reporting:
DISCOVERY_MULTI_ASSET_ADD will become
DEMAND_GEN_MULTI_ASSET_ADD and the corresponding reporting field
ad_group_ad.ad.discovery_multi_asset_ad will become
ad_group_ad.ad.demand_gen_multi_asset_ad
DISCOVERY_CAROUSEL_AD will become
DEMAND_GEN_CAROUSEL_AD and the corresponding reporting field
ad_group_ad.ad.discovery_carousel_ad will become
ad_group_ad.ad.demand_gen_carousel_ad
DISCOVERY_VIDEO_RESPONSIVE_AD will become
DEMAND_GEN_VIDEO_RESPONSIVE_AD and the corresponding reporting field
ad_group_ad.ad.discovery_video_responsive_ad will become
ad_group_ad.ad.demand_gen_video_responsive_ad
The GetAd endpoint will be removed. This brings the
AdService in line with other services in the Google Ads API. See our
guide on retrieving
objects for the recommended way to fetch ads and other resource types.
The way you manage segments for lifecycles goals is reworked. See the segment
your audiences section of the lifecycle goals documentation for a complete
overview.
When running a GoogleAdsService search or search stream
request for product_link, you can now only select fields related
to one linked product. Selecting multiple fields from different linked products
will result in a
QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
error.
Reporting
Renamed the metrics.sk_ad_network_conversion_value field to
metrics.sk_ad_network_fine_conversion_value.