v16.1.0 (2024-04-24)
The following features and changes were added in v16.1.
Account Management
CustomerNegativeCriterion.ip_block
which supports adding an IP as a negative criterion at the customer level.- New enum value:
ProductLinkError.LINK_EXISTS
. - New enum value:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Assets
- Support for assets related to Demand Gen to
ad_group_ad_asset_view
andasset_field_type_view
. - New enum value:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Audiences
- New enum value:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
which limits the number of lookalike user lists a customer can have to 1000.
Campaigns
- Support for returning Target
ROAS campaign bid simulations for
App campaigns using the
campaign_simulation
report. - New enum value:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - New enum value:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - New enum value:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Conversions
SkAdNetworkConversionValueSchema.postback_mappings
which supports SKAdNetwork 4.0 features.- Added support for warnings for
CustomerSkAdNetworkConversionValueSchemaService
asMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. When set totrue
, any non-blocking errors pertaining to operation failures will be returned asMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - New enum values in
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Criteria
- New fields in
BrandInfo
:display_name
primary_url
rejection_reason
status
- New enum:
BrandRequestRejectionReason
. - New enum value:
CriterionType.LIFE_EVENT
.
Experiments
- New enum value:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Local Services
local_services_lead.credit_details.credit_state
andlocal_services_lead.credit_details.credit_state_last_update_date_time
which returns the state of credit and the timestamp when the credit state was updated, respectively.local_services_lead_conversation.message_details.attachment_urls
which returns the URLs that can be used to download the contents of the attachment.
Videos
customer.video_brand_safety_suitability
andBrandSafetySuitability
which support retrieving video brand safety suitability at the customer level.- New enum value:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (2024-02-21)
The following features and changes were added in v16.
Account Management
- Migrated
advertising_partner
fromAccountLink
toProductLink
andProductLinkInvitation
. - Removed
data_partner
andgoogle_ads
fromAccountLink
. - Added
IdentityVerificationService
to manage advertiser verification.StartIdentityVerification()
is used to start a verification session using the providedverification_program
. It creates a new verification session and returns an empty response for a successfully created verification.GetIdentityVerification()
can be used for retrieving verification information, which returns several objects ofIdentityVerification
. EachIdentityVerification
includes:verification_program
which is the identity verification program typeidentity_verification_requirement
that contains details related to the deadline by which the advertiser should finish verificationverification_progress
that contains details related to the verification session including:program_status
represents the current status of this verification sessionaction_url
directs the customer to a URL to complete the verification.invitation_link_expiration_time
represents the expiration date for theaction_url
- Enums:
- Errors:
- Added
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Assets
- Changes to
asset_group
:- Added support for time-related segments, such as
segments.year
andsegments.month
. - Made
campaign
an attributed resource instead of segmenting resource.
- Added support for time-related segments, such as
Campaigns
- Changes to Demand Gen campaigns:
- Added support for setting
Campaign.shopping_setting
to an existing Demand Gen campaign. - Added
ShoppingSetting.disable_product_feed
to disable the optional product feed of Demand Gen campaigns. - Added
Ad.demand_gen_product_ad
and the correspondingDemandGenProductAdInfo
, available to Demand Gen campaigns with a non-nullCampaign.shopping_setting
.
- Added support for setting
- Added to following fields to
AdGroup
to show whether the ad group is serving or the reasons why it's not serving:primary_status
primary_status_reasons
- Added to following fields to
AdGroupAd
to show whether the ad group ad is serving or the reasons why it's not serving:primary_status
primary_status_reasons
- Added the following values to
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Experiment
- Added
Experiment.sync_enabled
to specify if sync should be enabled in the experiment. With sync enabled, changes made to the original campaign while your experiment is running, are automatically copied to the experiment campaign. - Added
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Added
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Hotel & Travel
- Added the following fields to
ListingDimensionInfo
for a Things to do ad to enable creating listing groups based on the state and city where the travel activity is available: - Added support for the following segments to
travel_activity_performance_view
:
Local Services
- Added
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
andBusinessRegistrationCheckArtifact
to allow advertisers to monitor the progress of the business registration verification process. - Added a new resource
local_services_employee
to allow advertisers to retrieve the employee information they've added.
Planning
- Removed
score
fromAudienceInsightsAttributeMetadata
.
Recommendations
- Added
RecommendationService.GenerateRecommendations()
which returns recommendations based on the specified settings, such as recommendation types and advertising channel types. This is particularly helpful during campaign construction. - Added
RecommendationMetrics.conversions_value
. - Recommended keywords with unset keyword match type now have
recommended_match_type
set toUNSPECIFIED
instead ofUNKNOWN
. - Added the following types of recommendations:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
which recommends opting in to the Maximize conversion value bidding strategyIMPROVE_GOOGLE_TAG_COVERAGE
which recommends deploying Google Tag on more pagesPERFORMANCE_MAX_FINAL_URL_OPT_IN
which recommends turning on final URL expansion for your Performance Max campaignsREFRESH_CUSTOMER_MATCH_LIST
which recommends updating a customer list that hasn't been updated in the last 90 daysCUSTOM_AUDIENCE_OPT_IN
which recommends creating a custom audienceLEAD_FORM_ASSET
which recommends adding lead form assets at the campaign or customer levelIMPROVE_DEMAND_GEN_AD_STRENGTH
which recommends improving ad strength on Demand Gen campaigns
Shopping
- Added
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
andCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
in order to provide more detailed errors for Shopping campaigns linked to a Comparison Shopping Service Center account. - Added the following values to
AssetGroupListingGroupFilterError
:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Lifecycle Goals
- Added
update
toCustomerLifecycleGoalOperation
andCampaignLifecycleGoalOperation
to make these operation types consistent with other operation types in the API.
v15 (2023-10-18)
The following new features and updates were introduced in v15.
Account Management
- If your account is suspended because of unauthorized account
activity,
customer.status
andcustomer_client.status
are now returned asSUSPENDED
. Previously, they were returned asENABLED
. - Added support for adding and removing a link between a Google Ads account and a Merchant Center account:
- Added
ProductLinkInvitationService
andProductLinkInvitation
to support updating a link invitation sent from other products, available for Hotel Center and Merchant Center accounts. - Removed
MerchantCenterLinkService
.- To link Google Ads accounts with Merchant Center accounts, use
ProductLinkInvitationService
andProductLinkService
.
- To link Google Ads accounts with Merchant Center accounts, use
- Removed
AccountLink.hotel_center
and support for updating link invitations from Hotel Center accounts usingAccountLinkService
.- To update a link invitation from a Hotel Center account, use
ProductLinkInvitationService
.
- To update a link invitation from a Hotel Center account, use
Assets
- Replaced
ImageAdInfo.media_file
withImageAdInfo.image_asset
to support adding and removing images using the assets. As a result, we also removedMediaFileService
, which is no longer needed. - Added
ListingGroupFilterDimension.webpage
to support creating a listing group filter based on custom labels and URL substrings.- Also replaced
AssetGroupListingGroupFilter.vertical
withAssetGroupListingGroupFilter.listing_source
andListingGroupFilterListingSource
- Also replaced
- Added
asset_group_asset.source
to show the source of the asset group asset. - Added
ad_group_ad_asset_view.source
to show the source of ad group ad asset.
Audiences
- For Customer Match, added
CustomerMatchUserListMetadata.consent
to support providing a consent. Starting on March 6, 2024 if consent is missing for EEA users, then the consent value is determined as not consented. Data from unconsented EEA users won't be processed and cannot be used for ad personalization using Customer Match. Check out our Customer Match guide for more details. - For Store Sales, added
UserData.consent
to support providing a consent. Check out our Store Sales guide for more details. If you are using Customer Match with store sales, review the FAQ for additional information. - Added
UserList.lookalike_user_list
to support creating a Lookalike segment, an audience created based on the provided existing seed audience. Lookalike segments can be used in a Demand Gen campaign only.
Campaigns
Updates to Performance Max campaigns:
AssetGroupSignal
now supports for two signal types that can be attached to an asset group for enhanced targeting:AssetGroupSignal.audience
- Added
Audience.scope
andAudience.asset_group
to limit audience usage to a specific asset group.Audience.asset_group
must be set if and only ifAudience.scope
isASSET_GROUP
.
- Added
AssetGroupSignal.search_theme
- Added
CriterionType.SEARCH_THEME
to support this new criterion type. This new criterion type can only be used in Performance Max campaigns to create anAssetGroupSignal
by populating theAssetGroupSignal.search_theme
with aSearchThemeInfo
criterion.
- Added
- Added
AssetGroupSignalOperation.exempt_policy_violation_keys
to support requesting exemption when adding asset group signals. - Added a new
asset_group_top_combination_view
to report the top performing assets at the asset group level. asset_group
can now be queried with metric fields to support retrieving the performance of a Performance Max campaign.- In
PerformanceMaxUpgradeStatus
, renamedUPGRADE_ELIGIBLE
toUPGRADE_ELIGIBLE
.
For Demand Gen and Discovery Target CPA campaigns, the campaign-level Target CPA bid simulations (
campaign_simulation.target_cpa_point_list.points
) now returnsTargetCpaSimulationPoint.interactions
instead ofTargetCpaSimulationPoint.clicks
.Added
BrandSuggestionService
that can suggest brands based on the provided brand prefix and the excluded list of brands. These brands can be used to create aBRAND
criterion, added to aBRANDS
shared set, and then attached to a campaign by creating aCampaignCriterion
withbrand_list
set to the shared set. The campaign criteria can be targeted in Search campaigns and excluded in Performance Max campaigns, respectively.Added
Campaign.asset_automation_settings[]
to show the automation status of each asset type.Added the following values to the
CampaignPrimaryStatusReason
enum:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversions
- Added
CallConversion.consent
andClickConversion.consent
to support providing a consent. Check out our call conversions guide and click conversions guide for more details. - Added the following fields related to
SKAdNetwork
conversions, available when querying them with
customer
orcampaign
: - Replaced
metrics.sk_ad_network_conversions
withmetrics.sk_ad_network_installs
. - Added support for diagnosing offline conversion upload
- Moved the
offline_conversion_upload_client_summary
from a field on thecustomer
resource to a top-level report. Use this report to obtain useful details of the conversion upload status such as the successful events count, success rate, and error percentage.- Caveat: A conversion that is uploaded but results in a
ConversionUploadError.CLICK_NOT_FOUND
error is still counted as successful, but it's also flagged as anOfflineConversionAlert
.
- Caveat: A conversion that is uploaded but results in a
- Added
job_id
as an optional parameter for the following request types so you can logically group multiple upload requests into a single conceptual job: - Added
INVALID_JOB_ID
to the following errors: - Replaced
INVALID_CONVERSION_ACTION
withNO_CONVERSION_ACTION_FOUND
andINVALID_CONVERSION_ACTION_TYPE
in the following errors:
- Moved the
- Added three reports to support Android Privacy Sandbox Cross-network
attribution without
redirects:
android_privacy_shared_key_google_campaign
which containsshared_campaign_key
and some fields that help encode the key.android_privacy_shared_key_google_ad_group
which containsshared_ad_group_key
and some fields that help encode the key.android_privacy_shared_key_google_network_type
which containsshared_network_type_key
and some fields that help encode the key.
- Added
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. AConversionActionOperation
that attempts to use one of the deprecated rule-based attribution models now fails with this error. Previously, the operation would fail with anUNKNOWN
error.
Hotel & Travel
- Added support for the following fields in
travel_activity_group_view
andtravel_activity_performance_view
:- Segments:
- Metrics:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Local Services Ads
- Added
LocalServicesSettings
and its fields to thecustomer
report for returning a Local Services advertiser's granular license and insurance statuses. - Added the following new reports for Local
Services:
local_services_lead
contains all the details pertaining to Local Services Ads leads such aslead_charged
,lead_type
,lead_status
.- Enums:
local_services_lead_conversation
contains message and phone conversation details such asconversation_channel
,call_duration_millis
,call_recording_url
.- Phone call recording URL is authenticated against the target customer account and its manager accounts.
local_services_verification_artifact
returns a Local Services advertiser's artifacts such as background check, business licenses, and business insurance data. Any documents associated with license and insurance can be accessed through a URL.
Planning
- Added support to return
Forecast.views
andPlannedProductForecast.views
forReachPlanService.ListPlannableProducts
for applicable product types. - Added support to return
PlannableTargeting.surface_targeting
forReachPlanService.ListPlannableProducts
, which describes the available surfaces for a product. - Added a new
ReachPlanSurface
enum. - Added support for targeting Target
frequency using
AdvancedProductTargeting.target_frequency_settings
, which returnsPlannedProductForecast.average_frequency
. - Added
AudienceInsightsService.GenerateSuggestedTargetingInsights
to return suggested targetable audiences. - Added the following values to
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Recommendations
- Added
RecommendationSubscriptionService
which manages recommendation subscriptions: - Added the following types of recommendations:
FORECASTING_SET_TARGET_CPA
which recommends setting a target CPA for campaigns that don't have one specified, in advance of a seasonal event that is forecasted to increase traffic.SET_TARGET_CPA
which recommends setting a target CPA for campaigns that don't have one specified.SET_TARGET_ROAS
which recommends setting a target ROAS for campaigns that don't have one specified.
Reporting
- Added the following new metrics, which can be queried with
campaign
(available for Display, Video, Discovery, and App campaigns) andsegments.device
:
Shopping
- Removed
ShoppingSetting.sales_country
, whose values are now returned asShoppingSetting.feed_label
.- You can continue to use a specific Merchant Center
feed for a campaign by using
the
ShoppingSetting.feed_label
field. It should be set to the feed label value or the two-letter country code previously used forShoppingSetting.sales_country
. For more details, see the support article for feed labels.
- You can continue to use a specific Merchant Center
feed for a campaign by using
the
- Removed the dependency of product categories on a country code in reporting.
The set of supported category IDs has not changed.
- Replaced the following fields used in
shopping_performance_view
:segments.product_bidding_category_level1
withsegments.product_category_level1
segments.product_bidding_category_level2
withsegments.product_category_level2
segments.product_bidding_category_level3
withsegments.product_category_level3
segments.product_bidding_category_level4
withsegments.product_category_level4
segments.product_bidding_category_level5
withsegments.product_category_level5
- Replaced
product_bidding_category_constant
withproduct_category_constant
, which returns all available localizations of a category in a repeated field. - Replaced
ListingDimensionInfo.product_bidding_category
withListingDimensionInfo.product_category
. - Replaced
ListingGroupFilterDimension.product_bidding_category
withListingGroupFilterDimension.product_category
.
- Replaced the following fields used in
- Removed support for adding
Campaign.shopping_setting
to Search campaigns. Trying to create a Search campaign withCampaign.shopping_setting
or addCampaign.shopping_setting
to an existing Search campaign now results inOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Removed support for adding
CampaignCriterion.listing_scope
to Search campaigns. Trying to addCampaignCriterion.listing_scope
to an existing Search campaign now results inOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Added following conversions with cart
data metrics:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- All these metrics are selectable with following reports:
Unified Goals
- Added
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
for configuring customer acquisition goals at the customer level.- Report:
customer_lifecycle_goal
- Report:
- Added
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
for configuring customer acquisition goals at the campaign level.- Report:
campaign_lifecycle_goal
- Report:
- Added
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - Added the following values to
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Videos
- Added support for targeting Google TV at the campaign level:
- Added support for targeting YouTube at the campaign level:
- Added
NetworkSettings.target_youtube
- In
AdNetworkType
, mergedYOUTUBE_WATCH
andYOUTUBE_SEARCH
intoYOUTUBE
. - Added
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Added
v14.1.0 (2023-08-09)
The following new features and updates were introduced in v14.1.
Account Management
Customer.customer_agreement_setting
which shows if the customer has accepted the lead form term of service
Assets
- New fields in
AssetGroup
to show whether the asset group is serving or the reasons why it's not serving:primary_status
primary_status_reasons
- New fields in
AssetGroupAsset
to show whether the asset group asset is serving or the reasons why it's not serving:primary_status
primary_status_details
primary_status_reasons
- New values in the
CallToActionType
enum:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- New values in the
AssetLinkError
enum:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
Billing
- New fields in
Invoice
andAccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
Campaigns
New values in the
CampaignPrimaryStatusReason
enum:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(Allowlisted accounts only)
DiscoveryCampaignSettings
withupgraded_targeting
:- When
upgraded_targeting
is set totrue
, you can add a location and a language as an ad group criterion
- When
Criteria
New enum value:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Allowlisted accounts only) Support for adding
LanguageInfo
andLocationInfo
as anAdGroupCriterion
:- This is available only for a Discovery campaign with upgraded targeting enabled
Experiments
- New values in the
ExperimentError
enum:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
Recommendations
- New types of recommendations:
PerformanceMaxOptInRecommendation
which recommends creating the first Performance Max campaign in the accountImprovePerformanceMaxAdStrengthRecommendation
which recommends improving the asset group's strength of a Performance Max campaignMigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
which recommends migrating a Dynamic Search Ad campaign to Performance Max
Reporting
- New metrics and segments about new versus returning customers:
- New
customer_search_term_insight
andcampaign_search_term_insight
views:metrics.search_volume
shows the volume range for a search term insight category
Shopping
- New fields for listing groups:
- New field:
ShoppingSetting.advertising_partner_ids
- New values in the
CampaignError
enum:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
Videos
- (Allowlisted accounts only)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
and its correspondingDiscoveryVideoResponsiveAdInfo
v14 (2023-06-07)
The following new features and updates were introduced in v14.
Campaigns
Conversions
Added support for identifying Google Analytics conversions and determining whether a conversion is imported from a Universal Analytics or GA4 property:
- Added the following values to
ConversionActionType
:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
- Added
ConversionAction.google_analytics_4_settings
- Added the following values to
Added
Customer.offline_conversion_client_summaries
, which summarizes the status and diagnostic information of the customer's offline conversion uploads and adjustments.- Enums
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- Enums
Added
job_id
to the responses returned byConversionAdjustmentUploadService.UploadConversionAdjustments
andConversionUploadService.UploadClickConversions
for associating a response to anOfflineConversionUploadSummary.job_id
.
Criteria
Added support for retrieving, creating and updating account-level negative keywords:
- Fields:
- Enums:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Errors:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
Hotel Ads
- Renamed
SuggestTravelAssetsRequest.place_id
toSuggestTravelAssetsRequest.place_ids
Planning
- Removed the following methods from
KeywordPlanService
:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- Added
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
to support generating keyword campaign forecast metrics without the need of creating a keyword plan first. - Removed support for retrieving the
campaign_criterion_simulation
report - Added support for
YOUTUBE_DYNAMIC_LINEUP
as a dimension inAudienceInsightsService.ListAudienceInsightsAttributes
. - Added
DynamicLineupAttributeMetadata.sample_channels
, used inGenerateAudienceCompositionInsights
responses to provide sample channels within lineups.
Recommendations
- Added
DynamicImageExtensionOptInRecommendation
which recommends enabling dynamic image extensions on the account - Added
LowerTargetRoasRecommendation
which recommends lowering target ROAS - Added
RaiseTargetCpaRecommendation
which recommends raising target CPA - Added
ResponsiveSearchAdAssetRecommendation.current_ad
Reporting
- Added the following values to
ServedAssetFieldType
, which are available fromad_group_ad_asset_view.pinned_field
:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
Archived release notes
See Sunsetted versions for archived release notes.