List Ad Group Criteria - Markifact

List Microsoft Ads ad-group audience associations, including custom segments, and other targeting criteria. Request one criterion type per call; returns native criteria with IDs for subsequent changes.


App	Microsoft Ads
Operation ID	`microsoft_ads_list_ad_group_criteria`
Type	Action
Connection	`microsoft_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`account`	object or array of object or MicrosoftAdsAccountItem or string or integer	Yes	-	Select the Microsoft Ads account.
`ad_group_id`	string or SelectItem	Yes	-	Ad group ID whose criteria to list.
`criterion_type`	enum (`Location`, `LocationIntent`, `Radius`, `DayTime`, `Age`, `Gender`, `Device`, `ProductPartition`, …)	Yes	-	One criterion type to read: Location (included and excluded locations), LocationIntent, Radius, DayTime (ad schedules), or another supported type. Request each type separately; Microsoft’s Targets mutation type cannot be used for reads. Use CustomSegment to inspect custom-segment associations. Returns all criteria of this type for the ad group. Audience is also a mutation-only type.
`return_additional_fields`	string	No	-	Optional native CriterionAdditionalField flags string, sent unchanged as ReturnAdditionalFields.

MicrosoftAdsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`customerId`	string	No	-	The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: List[Dict] Returns native Microsoft ad-group criterion objects.