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 keywords for. |
statuses | array of string or SelectableOption | No | - | Filter by keyword status. Leave empty to return all statuses. Available values: Active, Paused, Inactive. Deleted keywords are never returned by Microsoft Ads. |
editorial_statuses | array of string or SelectableOption | No | - | Filter by keyword 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 keyword properties (the MaxCpc inside MaxConversionValue bidding schemes) so the response is richer. Defaults to false. |
include_editorial_reasons | boolean | No | False | When true, fetch rejection details for the returned rows in batches of up to 1,000. Adds EditorialReasons containing Microsoft’s AppealStatus and Reasons (ReasonCode, Location, Term, PublisherCountries). Default: false; independent of return_additional_fields. A null collection means Microsoft returned no reasons, not confirmed approval. ReasonCode is Microsoft’s native code, not an explanation string. |
