> ## 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.

# Insert Regional Inventory

> Sets regional price and availability overrides for products, one or many at once (up to 200)

Sets regional price and availability overrides for products, one or many at once (up to 200). The fastest way to update prices per region without touching the product itself. Prices are raw Google micros (amountMicros).

|                       |                                 |
| --------------------- | ------------------------------- |
| **App**               | Google Merchant Center          |
| **Operation ID**      | `gmc_insert_regional_inventory` |
| **Type**              | Action                          |
| **Connection**        | `gmc` (required)                |
| **Credits per run**   | 1                               |
| **Agent / MCP tool**  | Yes                             |
| **Requires approval** | Yes (write operation)           |

## Inputs

| Field                     | Type                                          | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------- | --------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`                 | DynamicAccount                                | Yes      | -       | Select the Merchant Center account that owns the products.                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `update_type`             | string or SelectableOption                    | Yes      | -       | Choose whether to update one product's inventory or many at once. Options: single or bulk.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `product_id`              | string or SelectItem                          | No       | -       | Product identifier in the form contentLanguage~~feedLabel~~offerId, for example en~~US~~sku123. Required for single mode.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `inventory`               | object or string                              | No       | -       | Official Google Merchant API RegionalInventory body as an object or JSON string, sent as-is. Keys: region (region ID from gmc\_list\_regions) and regionalInventoryAttributes with price/salePrice (\{amountMicros, currencyCode}), salePriceEffectiveDate, and availability. Inserting for an existing region replaces the entry. Example: \{"region": "123456", "regionalInventoryAttributes": \{"price": \{"amountMicros": "33450000", "currencyCode": "USD"}, "availability": "IN\_STOCK"}}. Required for single mode. |
| `structured_data`         | array (also accepts a comma-separated string) | No       | -       | Use only when update\_type is bulk. A list of up to 200 rows, each with product\_id and inventory (the official RegionalInventory body).                                                                                                                                                                                                                                                                                                                                                                                   |
| `return_detailed_results` | boolean                                       | No       | `False` | Bulk mode only. If true, returns per-row results and does not raise on partial failures.                                                                                                                                                                                                                                                                                                                                                                                                                                   |

### 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. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns the inserted inventory (single) or counts and product IDs (bulk).

**Fields**: dynamic (depend on the inputs)