account | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Select the Microsoft Ads account that contains the ad. |
ad_group_id | string or SelectItem | Yes | - | The ad group ID that contains the ad. Do not include this inside update_payload. |
ad_id | string or SelectItem | Yes | - | The Microsoft Ads ad ID to update. Do not include this inside update_payload. |
ad_type | string or SelectableOption | Yes | - | The ad type (Type discriminator) of the ad being updated. Required because the UpdateAds endpoint needs it to validate the correct ad fields. Available values: Text, ExpandedText, ResponsiveSearch, ResponsiveAd, DynamicSearch, Product, Hotel, AppInstall. You can read it from the List Ads output (each ad’s Type). Do not include this inside update_payload. |
update_payload | object or string | Yes | - | Partial Microsoft Ads Ad object as JSON. This uses the REST UpdateAds endpoint: the runner sends AdGroupId and Ads[0].Id and Ads[0].Type separately, then merges only the fields provided here. Do not include identity fields such as AdGroupId, Id, ad_id, ad_group_id, ad_type, Type, account, or connection_id. Use care with nested asset collections such as Headlines or Descriptions because Microsoft replaces the entire submitted collection. Example payloads: {“FinalUrls”: [“https://example.com”]} or {“Status”: “Paused”} or {“Path1”: “shoes”, “Path2”: “sale”} |
dry_run | boolean | No | False | When true, return the resolved Microsoft Ads UpdateAds payload without calling Microsoft Ads. |
