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 |
level | string or SelectableOption | Yes | - | Level to apply audience targeting: ‘CAMPAIGN’ or ‘AD_GROUP’. For ‘display’ campaigns, audience targeting can only be applied at the ‘AD_GROUP’ level |
campaign_id | string or SelectItem | No | - | Select the campaign (required when level is CAMPAIGN) |
ad_group_id | string or SelectItem | No | - | Select the ad group (required when level is AD_GROUP) |
action | string or SelectableOption | Yes | - | Action to perform: ‘ADD’ appends the selected audience segments to existing targeting (does not overwrite current segments), ‘REMOVE’ removes only the selected segments. |
audience_setting | string or SelectableOption | No | - | Audience setting: ‘TARGETING’ (only show ads to audience) or ‘OBSERVATION’ (monitor & bid adjust). Only used when adding segments. |
user_lists | array of string or SelectableOption | No | - | User lists to target/remove. Accepts either resource names (e.g., ‘customers/{customer_id}/userLists/{user_list_id}’) or raw user_list_id values. |
affinity_segments | array of string or SelectableOption | No | - | Affinity segments to target/remove. Accepts either resource names (e.g., ‘customers/{customer_id}/userInterests/{user_interest_id}’) or raw user_interest_id values. |
in_market_segments | array of string or SelectableOption | No | - | In-market segments to target/remove. Accepts either resource names (e.g., ‘customers/{customer_id}/userInterests/{user_interest_id}’) or raw user_interest_id values. |
life_event_segments | array of string or SelectableOption | No | - | Life event resource names (e.g., ‘customers/{customer_id}/lifeEvents/{life_event_id}’) or numeric life_event_id values. |
detailed_demographics | array of string or SelectableOption | No | - | Detailed demographic resource names (e.g., ‘customers/{customer_id}/detailedDemographics/{detailed_demographic_id}’) or numeric extended_demographic_id values. |
custom_audiences | array of string or SelectableOption | No | - | Custom audiences to target/remove. Accepts either resource names (e.g., ‘customers/{customer_id}/customAudiences/{custom_audience_id}’) or raw custom_audience_id values. |
combined_audiences | array of string or SelectableOption | No | - | Combined audiences to target/remove. Accepts either resource names (e.g., ‘customers/{customer_id}/combinedAudiences/{combined_audience_id}’) or raw combined_audience_id values. |
