List Report Fields

Search and browse available Google Ads reporting metrics and dimensions before running reports

Search and browse available Google Ads reporting metrics and dimensions before running reports. Use filters to search fields by name or ID e.g [{‘field’:‘id’,‘operator’:‘REGEXP_MATCH’,‘value’:’.(cost|conversions).’}]. This is Markifact’s curated reporting field list, not the full Google Ads API surface; a resource attribute not listed here can still be fetched with gads_run_gaql_query.

App	Google Ads
Operation ID	gads_list_report_fields
Type	Action
Connection	None
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
field_type	string or SelectableOption	No	all	Filter by field type: ‘all’, ‘dimension’, or ‘metric’. Default is ‘all’.
filters	array of FilterItem	No	-	Use this to search fields by name or ID. Each filter must have a field, operator, and value. Available fields to filter by are: - ‘id’: The field ID [{“field”:“id”,“operator”:“REGEXP_MATCH”,“value”:”.(session|user).”}] - ‘name’: The field name [{“field”:“name”,“operator”:“CONTAINS”,“value”:“session”}] Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST.
limit	integer	No	-	The maximum number of fields to return. Set it to avoid too many results.

FilterItem

Field	Type	Required	Default	Description
field	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
operator	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’
value	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns list of available report fields.

Fields: id, name, type, data_type