account | GadsAccountItem or object or array of object or string or integer | Yes | - | Select the Google Ads account, ask user for it if not provided |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single Ad or multiple Ads at once. Available options: ‘single’ (Single Update), ‘bulk’ (Bulk Updates) |
ad_id | string or SelectableOption | No | - | Required for ‘single’ update mode. The same ad can sit in several ad groups, each with its own status, so identify the placement: ‘<adGroupId><adId>’ (e.g. ‘123325082381531279489801’), the full resource name ‘customers/<cust>/adGroupAds/<adGroupId>~<adId>’, or a bare ad ID together with ad_group_id. A bare ad ID alone works only when the ad is in one ad group; otherwise it is rejected with the list of ad groups. |
ad_group_id | string or SelectableOption | No | - | Ad group ID for ‘single’ update mode, used when ad_id is a bare ad ID. |
status | string or SelectableOption | No | - | Available options: ‘ENABLED’, ‘PAUSED’, ‘REMOVED’. Required for ‘single’ update mode |
structured_data | array (also accepts a comma-separated string) | No | - | Required when update type is ‘bulk’. Your data must have these columns or JSON Keys: ‘ad_id’ and ‘status’, plus ‘ad_group_id’ when ad_id is a bare ad ID. ad_id accepts the same forms as single mode. |
