account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account that owns the campaign. |
campaign_id | string or SelectItem | Yes | - | The Performance Max campaign to list asset groups for. |
statuses | array of string or SelectableOption | No | - | Filter by asset group status. Leave empty to return all statuses. Available values: Active, Paused, Expired. Deleted asset groups are never returned by Microsoft Ads. |
editorial_statuses | array of string or SelectableOption | No | - | Filter by asset group editorial (approval) status. Leave empty to return all. Available values: Active (approved), ActiveLimited, Disapproved, Inactive (under review). |
return_additional_fields | boolean | No | False | When true, request additional asset group properties (search themes, URL targets, tracking template, final URL suffix, URL custom parameters, cropping type) so the response is richer. Defaults to false. |
include_editorial_reasons | boolean | No | False | When true, fetch editorial details for nested TextAsset/ImageAsset links in returned asset groups, deduplicated and batched at up to 1,000 per asset type. Adds EditorialReasons beside each supported asset link’s EditorialStatus, with Microsoft’s AppealStatus and native Reasons (ReasonCode, Location, Term, PublisherCountries). A null collection means no reasons were returned, not confirmed approval. ReasonCode is a native code, not an explanation string. Default: false; independent of return_additional_fields. |
