> ## Documentation Index > Fetch the complete documentation index at: https://docs.markifact.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Listing Groups > Build or replace the listing group (product group) tree on a Shopping ad group Build or replace the listing group (product group) tree on a Shopping ad group. | | | | --------------------- | ---------------------------- | | **App** | Google Ads | | **Operation ID** | `gads_update_listing_groups` | | **Type** | Action | | **Connection** | `gads` (required) | | **Credits per run** | 1 | | **Agent / MCP tool** | Yes | | **Requires approval** | Yes (write operation) | ## Inputs | Field | Type | Required | Default | Description | | ---------- | ----------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `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 | | `ad_group` | string or SelectItem | Yes | - | The Shopping ad group to attach the listing group tree to. Must be a SHOPPING\_PRODUCT\_ADS ad group. | | `nodes` | string or array of ListingNode | Yes | - | The full listing group tree as a flat list of nodes. Provide exactly one root (SUBDIVISION with no parent\_temp\_id and no case\_value). Each SUBDIVISION needs an 'Other' child (a node whose case\_value has type matching its siblings but no value). All sibling nodes must share the same dimension type. 'Other' may be negative to exclude all remaining products. Google Ads validates the final tree. Accepts either a JSON string or a list. | ### GadsAccountItem | Field | Type | Required | Default | Description | | ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `value` | string | Yes | - | | | `label` | string | Yes | - | | | `managerId` | string | Yes | - | The manager ID for the Google Ads account. Ask user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. | ### ListingNode A single node in the listing group tree. | Field | Type | Required | Default | Description | | ---------------- | ---------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | `temp_id` | integer | Yes | - | Negative integer that uniquely identifies this node within the request (e.g. -1, -2, ...). Used to wire children to parents. | | `parent_temp_id` | integer | No | - | temp\_id of the parent SUBDIVISION node. Null for the root. | | `type` | enum (`SUBDIVISION`, `UNIT`) | Yes | - | SUBDIVISION (parent / non-leaf) or UNIT (leaf). | | `case_value` | ListingDimension | No | - | Dimension that places this node inside its parent's partition. Required for every non-root node. Omit on the root node. | | `cpc_bid` | number | No | - | CPC bid in account currency (e.g. 0.20 for \$0.20). Sent to Google Ads when provided; Google validates whether it is allowed. | | `negative` | boolean | No | `False` | If true, exclude products matching this UNIT from serving. Only valid on UNIT nodes; bids are not applied to negative units. | ### SelectItem | Field | Type | Required | Default | Description | | ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- | | `value` | string | Yes | - | The value of the selectable item. | | `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. | ### ListingDimension Describes the case\_value dimension of a listing group node. | Field | Type | Required | Default | Description | | --------------------- | -------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | enum (`BRAND`, `CONDITION`, `ITEM_ID`, `CUSTOM_LABEL`, `PRODUCT_TYPE`, `CATEGORY`, `CHANNEL`, `CHANNEL_EXCLUSIVITY`) | Yes | - | Dimension type. One of: BRAND, CONDITION, ITEM\_ID, CUSTOM\_LABEL, PRODUCT\_TYPE, CATEGORY, CHANNEL, CHANNEL\_EXCLUSIVITY. | | `value` | string | No | - | Value for the dimension. Used by BRAND (e.g. 'Nike'), ITEM\_ID (merchant offer id), CUSTOM\_LABEL (label string), PRODUCT\_TYPE (type name). Leave null for the 'Other' node. | | `condition` | string | No | - | Condition enum: NEW, USED, REFURBISHED. Used when type=CONDITION. | | `channel` | string | No | - | Channel enum: ONLINE, LOCAL. Used when type=CHANNEL. | | `channel_exclusivity` | string | No | - | Channel exclusivity enum: SINGLE\_CHANNEL, MULTI\_CHANNEL. Used when type=CHANNEL\_EXCLUSIVITY. | | `index` | integer | No | - | Index 0-4 for CUSTOM\_LABEL (which custom\_label\_0..4 is used) or for PRODUCT\_TYPE (which product type level 1-5 is used, 1-indexed). | | `category_id` | integer | No | - | Numeric Google product category id. Used when type=CATEGORY. | | `category_level` | integer | No | - | Product category level (1-5). Used when type=CATEGORY or PRODUCT\_TYPE if `index` is not provided. | ## Output **Type**: `Dict` Returns counts and resource names for the created criteria. **Fields**: `ad_group_id`, `criteria_count`, `resource_names`, `temp_id_to_resource_name`