Google Ads API Version 10 Now Available
|Google has released model 10.0 of the Google Classified ads API. Encourage in thoughts, the AdWords API will sundown on April 27, 2022, which is creating rapidly. So what is new in model 10 of the Google Classified ads API? A lot, including trim campaigns, efficiency max campaign upgrades, native carrier advertisements changes and plenty more and plenty more.
Google also added this new diff page that exhibits the protos that derive been added, removed, and adjusted within the most modern Google Classified ads API free up. You might possibly also click the links to glimpse the protos in our GitHub repository after they’re released. You might possibly also glimpse rapid and complete-context diffs within the Changed tab.
Google has a immediate video of the larger changes within the model 10.0 free up of the Google Classified ads API:
Account Administration
- Added Customer.repute and CustomerClient.repute, whose form is CustomerStatus to insist the repute of the memoir.
- You might possibly also now retrieve all forms of accounts when the usage of CustomerService.ListAccessibleCustomers, GoogleAdsService.Search and GoogleAdsService.SearchStream. Previously, they returned most fantastic ENABLED accounts and check accounts.
Classified ads
- Renamed Video TrueView Discovery Ad structure to In-Feed Video Ad:
- VideoTrueViewDiscoveryAdInfo is renamed to InFeedVideoAdInfo.
- AdType.VIDEO_TRUEVIEW_DISCOVERY_AD is renamed to AdType.IN_FEED_VIDEO_AD.
- Renamed MutateOperation.customizer_customizer_operation to MutateOperation.customer_customizer_operation.
Sources
- Added toughen for ad_group_ad_asset_combination_view for responsive search advertisements.
- Added toughen for reporting the efficiency of App pre registration advertisements in ad_group_ad_asset_view.
- For Picture and Media Bundle sources (Asset that has image_asset and media_bundle_asset gain 22 situation, respectively):
- Made name required.
- Added toughen for auto-renaming the asset names on creation. If an asset exists with the same name but totally different content, it’s renamed by appending the specified name with a timestamp and a counter.
- For the following asset kinds, if an asset with a special name having the same content already exists then the asset uploaded will seemingly be silently dropped. Picture, Media Bundle, Text, Name to Circulation abd Guide on Google
- Added the following values connected to asset items to ResourceLimitType: PAGE_FEED_ASSET_SETS_PER_CUSTOMER, DYNAMIC_EDUCATION_FEED_ASSET_SETS_PER_CUSTOMER, ASSET_PER_PAGE_FEED_ASSET_SET, ASSET_PER_DYNAMIC_EDUCATION_FEED_ASSET_SET
- Added the following values to AssetError: MOBILE_APP_INVALID_APP_ID, MOBILE_APP_INVALID_FINAL_URL_FOR_APP_DOWNLOAD_URL, NAME_REQUIRED_FOR_ASSET_TYPE
Audiences
- Added toughen for Viewers frail to derive a concentrating on in step with created dimensions, equivalent to demographics or memberships in user lists and user interests:
- Handy resource: Viewers
- Service: AudienceService
- Fields in totally different sources: GoogleAdsRow.viewers, Marketing and marketing campaign.audience_setting, AdGroup.audience_setting, AdGroupCriterion.viewers
- Enums: AudienceError and CriterionType.AUDIENCE
Bidding
- Removed toughen for creating seasonality changes on manager accounts.
- Added the following values to BiddingError: BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ALIGNED, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_ATTACHED_TO_THE_SAME_CAMPAIGNS_TO_ALIGN, BIDDING_STRATEGY_AND_BUDGET_MUST_BE_REMOVED_TOGETHER
Campaigns
- Natty campaigns derive exited open beta and entered fashioned availability.
- Added toughen for Native Services Classified ads campaigns as open beta.
- They’ve AdvertisingChannelType as LOCAL_SERVICES.
- Added toughen for retrieving these campaigns the usage of Search and SearchStream.
- Added toughen for updating their repute and amount_micros of their . associated CampaignBudget objects.
- Efficiency Max Campaigns now toughen asset neighborhood signals which advertisers can employ to insist the campaign who’s in all likelihood to severely change.
- Added Marketing and marketing campaign.use_vehicle_inventory for Natty Having a study about campaigns.
Conversions
- Added the following fields to the conversion_tracking_setting attribute of Customer:
- conversion_tracking_status signifies whether or now no longer the shopper is the usage of conversion tracking, and who is the conversion tracking proprietor.
- accepted_customer_data_terms signifies if the conversion tracking proprietor has current the shopper data phrases.
- enhanced_conversions_for_leads_enabled signifies if the shopper has opted into enhanced conversions for leads.
- Made ConversionAction.primary_for_goal now no longer mandatory to toughen setting the price to fraudulent at some level of derive operations.
- Made ConversionValueRuleSet.attachment_type immutable.
- Added ConversionValueRuleSet.conversion_action_categories and ValueRuleSetDimension.NO_CONDITION to toughen conversion price rules for retailer visits and retailer sales.
- Added the following values to ConversionValueRuleSetError: INELIGIBLE_CONVERSION_ACTION_CATEGORIES, DIMENSION_NO_CONDITION_USED_WITH_OTHER_DIMENSIONS, DIMENSION_NO_CONDITION_NOT_ALLOWED
- Removed LEAD from the ConversionActionCategory enum and replaced with the following new values: QUALIFIED_LEAD and CONVERTED_LEAD
- Added ExternalConversionSource.DISPLAY_AND_VIDEO_360_FLOODLIGHT.
Experiments
- Added a brand new ExperimentService with a gain 22 situation of unique sources, which is another choice to campaign experiments.
Resort Classified ads
- Added hotel_reconciliation.campaign and added toughen for the following metrics: metrics.hotel_commission_rate_micros and metrics.hotel_expected_commission_cost
Solutions
- Added toughen for returning ResponsiveSearchAdAssetRecommendation.
- Added toughen for returning UseBroadMatchKeywordRecommendation.
Reporting
- Mounted inconsistencies where rows with zero metrics derive been returned when segments derive been selected in some studies. All studies will now educate the expected behavior of ignoring zero-metric rows in studies that address shut out metrics and segments.
- Added a brand new meta parameter omit_unselected_resource_names. When gain 22 situation to factual, the response from GoogleAdsService will most fantastic return helpful resource name fields that you explicitly ask within the SELECT clause of your question.
- When retrieving Marketing and marketing campaign.start_date and Marketing and marketing campaign.end_date, the date returned will repeatedly be formatted in step with the time zone of the shopper specified as customer_id of SearchGoogleAdsRequest or SearchGoogleAdsStreamRequest. Previously, the returned date could fluctuate in step with the time zone of the manager memoir specified by login-customer-id.
- Added toughen for metrics.absolute_top_impression_percentage and metrics.top_impression_percentage; in geographic_view and with segments.hour
- Added toughen for the following segments for metrics.sk_ad_network_conversions (SKAdNetwork conversions), which is obtainable when fetching the details of shopper or campaign: segments.sk_ad_network_user_type, segments.sk_ad_network_ad_event_type, segments.sk_ad_network_source_app.sk_ad_network_source_app_id
- Added metrics.biddable_app_install_conversions and metrics.biddable_app_post_install_conversions.
RMF
- Added new necessities for Efficiency Max and Natty campaigns. We’re also documenting the mandatory minimal efficiency for somewhat a pair of developer instruments equivalent to browsing, resort and app campaigns, and simplifying fashioned browsing campaigns to align with elephantine carrier campaigns.
Discussion board dialogue at Twitter.