Google Adverts has released a significant model launch for the Google Adverts API, version 17. Model 17 contains preparation for useful resource utilization coverage modifications, web page measurement modifications, batch reporting modifications, extra PMax and match sort reporting, plus rather more.
Once more, it is a main launch of this replace, earlier than that was version 16.1 after which Version 16 in February 2024. Earlier than that was model 15 again in October 2023. Then earlier than that was version 14.1 which was launched in August. Version 13.1 preceded this new model, which was launched in April 2023. Version 12.0 was launched in October 2022, Version 11.0 of the Google Adverts API was launched in June, and version 11.1 was in August. Additionally Version 10.1 was launched on April 27, 2022 and version 10.0 was launched on February 9, 2022. And Google has sunset the AdWords API on April twenty seventh which can fully cease working on the end of July.
Here’s a video overview of the modifications:
Right here is the total change log:
Adverts
- Eliminated AdService.getAd. This brings the AdService according to different companies within the Google Adverts API. See Retrieving objects for the really useful option to fetch adverts and different useful resource sorts.
- Added extra validations for ImageAdInfo.image_asset relating to dimensions and format. The next errors could also be thrown if the picture is invalid: ImageError.UNEXPECTED_SIZE, ImageError.FORMAT_NOT_ALLOWED
Belongings
- Added new enum: ClickType.AD_IMAGE
- Added the next new reviews with new metrics for Efficiency Max and Search campaigns: campaign_aggregate_asset_view and channel_aggregate_asset_view
Audiences
- Added OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED
Batch Jobs
- Added BatchJobError.REQUEST_TOO_LARGE, which shall be thrown when the submitted AddBatchJobOperationsRequest is bigger than 10484504 bytes.
- Added assist for setting MutateOperation.asset_group_operation when utilizing BatchJobService. This allows you to use batch processing to create and handle total Efficiency Max campaigns. See our new devoted information.
Campaigns
- Renamed Discovery to Demand Gen in all fields, enums, errors of all assets throughout the Google Adverts API, akin to campaigns, adverts, and belongings. For instance, AdvertisingChannelType.DISCOVERY is now AdvertisingChannelType.DEMAND_GEN.
- Added Marketing campaign.keyword_match_type to allow you to set key phrase match sort for all key phrases in a marketing campaign.
Conversions
- For SKAdNetwork conversions, Renamed segments.sk_ad_network_conversion_value to segments.sk_ad_network_fine_conversion_value. and Added segments.sk_ad_network_redistributed_fine_conversion_value.
- The next metrics are actually returned with the response even when they’re zero. This makes them per different metrics. metrics.all_conversions_value_by_conversion_date, metrics.all_conversions_by_conversion_date, metrics.conversions_value_by_conversion_date, metrics.conversions_by_conversion_date
Standards
- Added to following fields to AdGroupCriterion to point out whether or not the advert group criterion is serving or the the explanation why it is not serving: primary_status and primary_status_reasons.
- Added assist for metrics.search_impression_share for gender_view
- Added assist for metrics.phone_calls for keyword_view
Native Companies
- Added LocalServicesLeadService.AppendLeadConversation() used to append a brand new LocalServicesLeadConversation to LocalServicesLead, which sends the messages to customers by means of applicable channels like SMS relying on how the lead was created. The scale of AppendLeadConversationRequest.conversations is restricted to 1,000. Solely LocalServicesLead with lead_type set to LeadType.MESSAGE could be laid out in Dialog.local_services_lead.
- Added new enum values to ConversationType: WHATSAPP to symbolize a dialog launched by means of WhatsApp. ADS_API to symbolize a dialog launched utilizing the brand new LocalServicesLeadService.AppendLeadConversation() methodology.
- Added the next new fields to local_services_verification_artifact: local_services_verification_artifact.insurance_verification_artifact.expiration_date_time and local_services_verification_artifact.license_verification_artifact.expiration_date_time
Reporting
- Now you can choose solely fields associated to at least one linked product when querying product_link. Choosing a number of fields of a number of linked merchandise will throw QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. For instance, product_link.advertising_partner.buyer and product_link.data_partner.data_partner_id can’t be chosen in the identical question.
- Passing a page_size to GoogleAdsService.Search will lead to a RequestError.PAGE_SIZE_NOT_SUPPORTED error.
Purchasing
- Added a brand new report shopping_product, which corresponds to the Merchandise web page of the Google Adverts UI. It helps returning information associated to the present state of merchandise from Google Service provider Heart accounts linked to a Google Adverts account.
- You may filter metrics from the shopping_product report utilizing segments.date when utilizing GoogleAdsService.Search or GoogleAdsService.SearchStream. Segmentation by date isn’t permitted and can return a ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION error.
Unified Targets
- Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure viewers buyer sorts.
- Eliminated CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. To configure viewers settings of buyer lifecycle targets, use UserListCustomerTypeService.MutateUserListCustomerTypes() as an alternative.
- Connect or unattach a person record by setting UserListCustomerType.customer_type_category to UserListCustomerTypeCategory.PURCHASERS to incorporate it into or exclude it from an present buyer definition for buyer lifecycle targets, respectively. Go to section your audiences for extra particulars.
Movies
- Added the next values to ContentLabelType. You may exclude these ContentLabelTypes on the buyer degree: BRAND_SUITABILITY_CONTENT_FOR_FAMILIES, BRAND_SUITABILITY_GAMES_FIGHTING, BRAND_SUITABILITY_GAMES_MATURE, BRAND_SUITABILITY_HEALTH_SENSITIVE, BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED, BRAND_SUITABILITY_NEWS_RECENT, BRAND_SUITABILITY_NEWS_SENSITIVE, BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED, BRAND_SUITABILITY_POLITICS, BRAND_SUITABILITY_RELIGION
- Added AdVideoAsset.ad_video_asset_info to assist stock preferences for video belongings when creating DemandGenVideoResponsiveAdInfo.
- (Allowlisted accounts solely) Made Marketing campaign.video_brand_safety_suitability mutable.
Discussion board dialogue at X.