Google Launched Advertisements API Model 10.1

Google has launched model 10.1 of the Google Advertisements API, which is an replace from the main launch of model 10 from early February 2022. The massive additions in v10.1 embody the addition of uncover campaigns, marketing campaign teams, native service campaigns and extra.

Right here is the total record of modifications in model 10.1:

Property

• Added the next for lead types: Assist for retrieving submitted lead type knowledge by way of LeadFormSubmissionData utilizing GoogleAdsService.Search and GoogleAdsService.SearchStream and LeadFormAsset.custom_question_fields
• Added the next asset varieties: Added dynamic_real_estate_asset to Asset to assist dynamic actual property belongings, Added dynamic_custom_asset to Asset to assist dynamic customized belongings, Added dynamic_hotels_and_rentals_asset to Asset to assist dynamic accommodations and leases belongings, Added dynamic_flights_asset to Asset to assist dynamic flights belongings, Added dynamic_travel_asset to Asset to assist dynamic journey belongings, Added dynamic_local_asset to Asset to assist dynamic native belongings, Added dynamic_jobs_asset to Asset to assist dynamic jobs belongings
• Added assist for the next fields to asset_group_product_group_view: asset_group and asset_group_listing_group_filter
• Added ad_group_ad_asset_combination_view.enabled.
• Added AssetError.NAME_CONFLICT_FOR_ASSET_TYPE.

Audiences

• Added assist for metrics.absolute_top_impression_percentage and metrics.top_impression_percentage in campaign_audience_view and ad_group_audience_view.
• Added ResourceLimitType.RULE_BASED_USER_LISTS_PER_CUSTOMER.
• Added the next values to AudienceError: AUDIENCE_SEGMENT_NOT_FOUND, AUDIENCE_SEGMENT_TYPE_NOT_SUPPORTED, DUPLICATE_AUDIENCE_SEGMENT, TOO_MANY_SEGMENTS, TOO_MANY_DIMENSIONS_OF_SAME_TYPE, IN_USE

Batch Jobs

• Added BatchJobOperation.take away to assist eradicating batch jobs within the PENDING state.

Campaigns

• Added assist for retrieving, creating, and updating Discovery campaigns, their advert teams, and their adverts.
• Enums: AdvertisingChannelType.DISCOVERY, AdType.DISCOVERY_CAROUSEL, AdType.DISCOVERY_MULTI_ASSET, AssetType.DISCOVERY_CAROUSEL_CARD
• Added assist for retrieving, creating, and updating marketing campaign teams: Useful resource: CampaignGroup, Service: CampaignGroupService, Fields in different sources: Marketing campaign.campaign_group and GoogleAdsRow.campaign_group, Enums: CampaignGroupError, CampaignGroupStatus
• Native Providers campaigns, beforehand in Beta, at the moment are in usually availability
• Added legacy assist for the next dimensions to ListingDimensionInfo for Show campaigns solely: ProductGroupingInfo, ProductLabelsInfo, ProductLegacyConditionInfo, ProductTypeFullInfo

Change Historical past

• Added the next values to ChangeEventResourceType: ASSET_SET, ASSET_SET_ASSET, CAMPAIGN_ASSET_SET

Conversions

• Added ConversionTrackingSetting.google_ads_conversion_customer, used to find out which Google Advertisements account is managing your account’s conversions.
• Added ClickConversion.conversion_environment to assist reporting the atmosphere on which a conversion was recorded. This function is out there to allowlisted accounts solely.
• Added assist for metrics.all_conversions_value and metrics.all_conversions in conversion_action.
• Added ConversionValueRuleSetError.UNSUPPORTED_CONVERSION_ACTION_CATEGORIES.
• Added ConversionAdjustmentUploadError.MISSING_ORDER_ID_FOR_WEBPAGE.
• Added ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS.

Standards

• Added CriterionError.CANNOT_TARGET_CUSTOMER_MATCH_USER_LIST.

Experiments

• Added ExperimentError.STATUS_TRANSITION_INVALID.

Lodge Advertisements

• Added assist for getting hotel_center_id by way of AccountLink.hotel_center.

Planning

• Added KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics. It returns the historic metrics for a given record of key phrases with out asking for any plan, campaigns, or advert teams.
• Added KeywordPlanHistoricalMetrics.average_cpc_micros which is the common value per click on in micros of a given key phrase.
• Added a brand new subject HistoricalMetricsOption.include_average_cpc, which is utilized in GenerateKeywordIdeasRequest.historical_metrics_options as a flag to request KeywordPlanHistoricalMetrics.average_cpc_micros to be included within the response. The default worth if not specified is fake.
• Added GenerateKeywordIdeaResult.close_variants which is the record of shut variants from the requested key phrases which might be mixed into this GenerateKeywordIdeaResult.

Reporting

• segments.click_type now returns CROSS_NETWORK for Efficiency Max and Discovery campaigns.
• Added the next fields for SKAdNetwork conversion segments, obtainable when fetching the info of buyer or marketing campaign: metrics.sk_ad_network_conversions and segments.sk_ad_network_attribution_credit
• Made metrics.absolute_top_impression_percentage and metrics.top_impression_percentage suitable with segments.geo_target_region and segments.geo_target_city.

Video

• Added VideoResponsiveAdInfo.breadcrumb1 and VideoResponsiveAdInfo.breadcrumb2.

As a reminder, the legacy Google AdWords API sundown yesterday.

Discussion board dialogue at Twitter.