Release Notes

0.5.0 (2018-10-31)

The functionality and changes below were added in v0.5.0.

Account Management

Billing

  • BillingSetupService
    • Create a new billing setup.
    • Cancel an approved billing setup that is scheduled to start in the future.
    • Cancel a pending billing setup that is not yet approved.
  • AccountBudgetService
    • View all approved account-level budgets, including budget adjustments.
    • View currently pending account-level budget proposals (if any).
  • AccountBudgetProposalService
    • Create account-level budget proposal to update a budget or create a new budget.
    • View all account-level budget proposals. All approved values and proposed budget values are visible. Approved values are prefixed with approved_.

Campaigns

  • Create campaigns with AdvertisingChannelSubType DISPLAY_GMAIL_AD for Gmail Ad campaigns and DISPLAY_SMART_CAMPAIGN for Smart Display campaigns.
  • Query more Metrics for accounts, campaigns, ad groups, keywords, and bidding strategies.

Change history

Creatives

  • MediaFileService
    • A service to upload media to be used in ads.
  • Create call-only ads with CallOnlyAdInfo.
  • Set and create the ad rotation mode on an ad group.
  • Query Metrics such as impressions, clicks, cost, conversions, and average position for ads.

Conversion tracking

  • Lets you measure the performance of your advertising against your business goals.
  • Conversion actions
    • Set up and edit the settings associated with your conversion actions, including website tracking and call conversion tracking.

Hotel Ads

  • Use Google Ads Query Language to query hotel group stats. For each hotel group:
    • Read the corresponding listing group case value.
    • Read direct child listing groups' types.
    • Read the parent listing group ID.
    • Read the listing group path, which contains the case value from the root node of the hotel group tree to the current hotel group.

Location, Demographics, and Criteria

  • GeoTargetConstantService
    • A service for retrieving geo constants and suggesting geo constants based on input.
  • Create criterion with CriterionType AGE_RANGE, GENDER, INCOME_RANGE, PARENTAL_STATUS, PLACEMENT, PROXIMITY, TOPIC, YOUTUBE_CHANNEL, and YOUTUBE_VIDEO to identify when and where to show ads.
  • Define PLACEMENT in SharedCriterion.
  • Retrieve Metrics for audiences, age ranges, display keywords, gender, parental status, and display topics.

Shopping

  • ProductGroupView resource
    • Supported metrics
      • all_conversions_from_interactions_rate
      • all_conversions
      • all_conversions_value
      • average_cpc
      • average_cpm
      • benchmark_average_max_cpc
      • clicks
      • conversions_from_interactions_rate
      • conversions
      • conversions_value
      • cost_micros
      • cost_per_all_conversions
      • cost_per_conversion
      • cross_device_conversions
      • ctr
      • impressions
      • search_click_share
      • search_impression_share
      • value_per_all_conversions
      • value_per_conversion
      • view_through_conversions
    • Supported segments
      • ad_network_type
      • date
      • day_of_week
      • device
      • month
      • month_of_year
      • quarter
      • week
      • Year

0.4.0 (2018-09-21)

The functionality and changes below were added in v0.4.0.

Whitelist removed

The whitelist for the Beta has been removed. All API users who have an existing developer token in the AdWords API can use that developer token for the Google Ads API.

Billing

  • BillingSetupService

    • Designate the business entity responsible for an account's accrued costs.
    • Each billing setup is associated with a Payments account. All billing setups pointing to the same Payments account will appear on a single monthly invoice.
    • You can cancel a pending or future approved billing setup. Note that not all settable fields are exposed yet, including the billing setup's start and end times.
    • Note that creating or changing billing setups is not supported yet.
  • AccountBudgetProposalService

    • Create new budgets and make changes to existing budgets, including:
      • edit existing budgets
      • end a currently running budget
      • remove a budget (approved to start in the future)
    • Cancel proposals that are still pending.
    • There are some fields that are currently settable, but are not yet selectable.
    • Approved values (i.e., if there is a discrepancy between the proposed budget value and the approved value) will be exposed as fields prefixed with approved_ in a future version.
    • Reads for account-level budgets managed by these proposals will be supported in a future version. Please use BudgetOrderService until then.

Campaigns

Change history

  • ChangeStatus in GoogleAdService.Search
    • Retrieves the current status of resources that have changed since a requested time.
    • Supported resources are:
      • AD_GROUP
      • AD_GROUP_AD
      • AD_GROUP_CRITERION
      • CAMPAIGN
      • CAMPAIGN_CRITERION

Creatives

  • The field policy_validation_parameter has been added to the AdGroupAdOperation. It enables setting policy topics that should be ignored so the ad can be saved despite having policy validations.
  • The field policy_summary has been added to AdGroupAd to display the current approval status of an ad (including any policy violations ignored).
  • The fields ad.added_by_google_ads and ad.device_preference were added in AdGroupAd.

Conversion tracking

Conversion tracking lets you measure the performance of your advertising against your business goals. The API will allow you to set up and edit your conversion tracking setup.

  • With ConversionAction, you can set up and edit the settings associated with your conversion actions including website tracking and call conversion tracking.

Shopping

  • Standard Shopping Campaigns
    • CampaignService
      • Create standard Shopping campaigns with SHOPPING.advertising_channel_type.
      • Supported bidding strategy types: MANUAL_CPC, TARGET_SPEND, TARGET_ROAS.
    • BiddingStrategyService
      • Create portfolio bidding strategy of types ENHANCED_CPC, TARGET_SPEND, TARGET_ROAS.
    • AdGroupService
      • Create ad groups of type SHOPPING_PRODUCT_ADS.
    • AdGroupAdService
      • Create ads of type SHOPPING_PRODUCT_AD.
    • AdGroupCriterionService
      • Subdivide product offers through listing groups, which represent product groups.
      • Supported listing dimension types:
        • Product Condition
        • Product Type
        • Listing Brand
        • Custom Attribute (L0-4)
        • Product Channel
        • Product Channel Exclusivity
        • Product Offer Id

Video

  • GoogleAdsService
  • Video Ads
    • Video specific metrics
      • Video views, video view rate
      • Video quartiles
      • View-through conversions
  • Video creatives
  • ManualCPV bidding strategy

0.3.0 (2018-08-29)

Campaigns

The following were added or changed.

Creatives

  • For ad disapproval error handling, PolicyFindingDetails replaces PolicyViolationDetails for expanded text ads.

Hotel Ads

  • The parent_criterion_id (int64) in ListingGroupInfo has been replaced with parent_criterion. The new field is a string that contains the resource name of the parent criterion.

Queries

Recommendations

  • Recommendations added:
  • MaximizeConversionsOptInRecommendation
  • EnhancedCpcOptInRecommendation
  • MaximizeClicksOptInRecommendation
  • SearchPartnersOptInRecommendation
  • OptimizeAdRotationRecommendation
  • The dismissed field was added to Recommendation resource to allow you to search, get, and apply dismissed recommendations.

Shopping

  • Smart Shopping Campaigns
    • CampaignService
      • Create campaigns with advertising_channel_sub_type SHOPPING_SMART_ADS.
      • Supported bidding strategy type: MAXIMIZE_CONVERSION_VALUE.
    • AdGroupService
      • Create ad groups of type SHOPPING_SMART_ADS.
    • AdGroupAdService
      • Create ads of type SHOPPING_SMART_AD.
    • AdGroupCriterionService
      • Subdivide product offers through listing groups, which represent product groups.
        • Supported listing dimension types:
          • Product Condition
          • Product Type
          • Listing Brand
          • Custom Attribute (L0-4)

0.2.0 (2018-06-14)

Hotel Ads

0.1.0 (2018-06-05)

Campaigns

Search Campaigns

Hotel Ads

Recommendations

  • Recommendations include:
    • Keyword
    • CampaignBudget
    • TextAd (expanded text ads)
    • TargetCpaOptIn
  • GoogleAdsService.Search
    • Search for Recommendations supports filtering and selecting with ad group, campaign, or campaign budget (depending on the Recommendation).
  • RecommendationService
    • Apply Recommendations allows either applying the recommendation as-is or overriding and applying the recommendation.
    • GetRecommendation allows the retrieval of one recommendation at a time and is meant for exploratory use rather than the retrieval of multiple recommendations. To retrieve multiple campaigns in one call, use GoogleAdsService.

Customer

0.0.0 (2018-04-23)

GoogleAdsFieldService

  • GoogleAdsFieldService provides a catalog of all queryable fields. The metadata on these fields includes descriptions, types, and compatibility with other fields. Learn more.

GoogleAdsService

  • GoogleAdsService is meant for retrieving multiple resources in a single query. Queryable resources include:

    • Customer
    • Campaign
    • AdGroup
    • AdGroupAd
    • CampaignBudget
    • BiddingStrategy
  • Metrics such as impressions and clicks can also be retrieved using GoogleAdsService for these resources:

    • Customer
    • Campaign
    • AdGroup
    • AdGroupAd
    • CampaignBudget
    • BiddingStrategy
    • KeywordView (Keyword)
  • GoogleAdsService allows segmentation by fields, such as date fields. Learn more.

Services for resources

CampaignService

  • MutateCampaigns creates, updates, or removes search campaigns. It can also configure network settings and bidding strategies.

  • GetCampaign retrieves one campaign at a time. It is meant for exploratory use rather than for retrieval of multiple campaigns. To retrieve multiple campaigns in a single call, use GoogleAdsService. Learn more.

CampaignBudgetService

  • MutateCampaignBudgets creates, updates, or removes campaign budgets.

  • GetCampaignBudget is meant for exploratory use rather than for retrieval of multiple campaign budgets. To retrieve multiple campaign budgets, use GoogleAdsService. Learn more.

AdGroupService

  • MutateAdGroups creates, updates, or removes ad groups under search campaigns. It can also set bids on ad groups.

  • GetAdGroup retrieves one ad group at a time. It is meant for exploratory use rather than for retrieval of multiple ad groups. To retrieve multiple ad groups, use GoogleAdsService. Learn more.

AdGroupAdService

  • MutateAdGroupAds creates, updates, or removes ads in search campaigns. Supported ads are listed in AdType and include:

    • TEXT_AD
    • EXPANDED_TEXT_AD
    • DYNAMIC_SEARCH_AD
    • CALL_ONLY_AD
    • EXPANDED_DYNAMIC_SEARCH_AD
  • GetAdGroupAd retrieves one ad at a time. It is meant for exploratory use rather than for retrieval of multiple ads. To retrieve multiple ads, use GoogleAdsService. Learn more.

BiddingStrategyService

  • MutateBiddingStrategies creates, updates, or removes search campaign bidding strategies. Both standard and portfolio bidding strategies are supported.

  • GetBiddingStrategy retrieves one bidding strategy at a time. It is meant for exploratory use rather than for retrieval of multiple bidding strategies. To retrieve multiple bidding strategies, use GoogleAdsService. Learn more.

CampaignCriterionService and AdGroupCriterionService

  • MutateCampaignCriteria and MutateAdGroupCriteria create, update, or remove keyword criteria in search campaigns.

  • GetCampaignCriterion and GetAdGroupCriterion retrieve one criterion at a time. They are meant for exploratory use rather than for retrieval of multiple criteria. To retrieve multiple criteria, use GoogleAdsService. Learn more.

CustomerService

  • GetCustomer retrieves specific details about an account.

Send feedback about...

Google Ads API Beta
Google Ads API Beta
Need help? Visit our support page.