Join us live on Discord on the Google Advertising and Measurement Community server and on YouTube on February 26th at 10:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.

KeywordPlanAggregateMetricResults

The aggregated historical metrics for keyword plan keywords.

Proto definition

Fields

Fields
`device_searches[]`	`KeywordPlanDeviceSearches` The aggregate searches for all the keywords segmented by device for the specified time. Supports the following device types: MOBILE, TABLET, DESKTOP. This is only set when KeywordPlanAggregateMetricTypeEnum.DEVICE is set in the KeywordPlanAggregateMetrics field in the request.

`device_searches[]`

KeywordPlanDeviceSearches

The aggregate searches for all the keywords segmented by device for the specified time. Supports the following device types: MOBILE, TABLET, DESKTOP.

This is only set when KeywordPlanAggregateMetricTypeEnum.DEVICE is set in the KeywordPlanAggregateMetrics field in the request.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-23 UTC.

Blog
Visit our blog for important announcements.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.

KeywordPlanAggregateMetricResults Stay organized with collections Save and categorize content based on your preferences.

device_searches[]

KeywordPlanAggregateMetricResults

`device_searches[]`