Google Ads API Version 17 Now Out

Google Advertisements has released a serious model launch for the Google Advertisements API, version 17. Model 17 consists of preparation for useful resource utilization coverage modifications, web page dimension modifications, batch reporting modifications, extra PMax and match sort reporting, plus rather more.

Once more, this can be 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 Advertisements 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 is able to fully cease working on the end of July.

Here’s a video overview of the modifications:

Right here is the complete change log:

Advertisements

• Eliminated AdService.getAd. This brings the AdService in step with different companies within the Google Advertisements API. See Retrieving objects for the beneficial approach to fetch advertisements 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

Property

• Added new enum: ClickType.AD_IMAGE
• Added the next new experiences 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 can be thrown when the submitted AddBatchJobOperationsRequest is bigger than 10484504 bytes.
• Added help for setting MutateOperation.asset_group_operation when utilizing BatchJobService. This allows you to use batch processing to create and handle whole Efficiency Max campaigns. See our new devoted information.

Campaigns

• Renamed Discovery to Demand Gen in all fields, enums, errors of all sources throughout the Google Advertisements API, resembling campaigns, advertisements, and property. 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 at the moment are returned with the response even when they’re zero. This makes them in line with 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 indicate whether or not the advert group criterion is serving or the explanation why it isn’t serving: primary_status and primary_status_reasons.
• Added help for metrics.search_impression_share for gender_view
• Added help 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 via 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 characterize a dialog launched via WhatsApp. ADS_API to characterize 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 end in a RequestError.PAGE_SIZE_NOT_SUPPORTED error.

Procuring

• Added a brand new report shopping_product, which corresponds to the Merchandise web page of the Google Advertisements UI. It helps returning knowledge associated to the present state of merchandise from Google Service provider Heart accounts linked to a Google Advertisements account.
• You’ll be able to filter metrics from the shopping_product report utilizing segments.date when utilizing GoogleAdsService.Search or GoogleAdsService.SearchStream. Segmentation by date is just not permitted and can return a ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION error.

Unified Objectives

• Added UserListCustomerTypeService.MutateUserListCustomerTypes() to configure viewers buyer sorts.
• Eliminated CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. To configure viewers settings of buyer lifecycle objectives, use UserListCustomerTypeService.MutateUserListCustomerTypes() as a substitute.
• Connect or unattach a consumer record by setting UserListCustomerType.customer_type_category to UserListCustomerTypeCategory.PURCHASERS to incorporate it into or exclude it from an current buyer definition for buyer lifecycle objectives, respectively. Go to phase your audiences for extra particulars.

Movies

• Added the next values to ContentLabelType. You’ll be able to exclude these ContentLabelTypes on the buyer stage: 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 help stock preferences for video property when creating DemandGenVideoResponsiveAdInfo.
• (Allowlisted accounts solely) Made Marketing campaign.video_brand_safety_suitability mutable.

Discussion board dialogue at X.