account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account that owns the ad group. |
ad_group_id | string or SelectItem | Yes | - | The ad group to list ads for. |
statuses | array of string or SelectableOption | No | - | Filter by ad status. Leave empty to return all statuses. Available values: Active, Paused, Inactive. Deleted ads are never returned by Microsoft Ads. |
editorial_statuses | array of string or SelectableOption | No | - | Filter by ad 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 ad properties (videos, long headlines, impression tracking URLs, etc.) so the response is richer. Defaults to false. |
include_editorial_reasons | boolean | No | False | When true, fetch editorial details for returned ads and their nested TextAsset/ImageAsset links in batches of up to 1,000 per entity type. Adds EditorialReasons to each ad and supported asset link, alongside its EditorialStatus, containing Microsoft’s AppealStatus and Reasons (ReasonCode, Location, Term, PublisherCountries). Default: false; independent of return_additional_fields (enable it to also return optional assets such as long headlines). A null collection means Microsoft returned no reasons, not confirmed approval. ReasonCode is Microsoft’s native code, not an explanation string. |
