Release Notes

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.