Inventory Blueprint
12 REST endpoints to generate ad unit hierarchies and manage size bundles and size mappings.
REST endpoints
| Method | Path | Description | Credits |
|---|---|---|---|
| POST | /gam/blueprint/generate | Generate an ad unit hierarchy from a template | 0 |
| POST | /gam/blueprint/validate | Validate an ad unit structure | 0 |
| POST | /gam/blueprint/export | Export as JSON/CSV/GAM Batch | 0 |
| GET | /gam/blueprint/templates | List the available templates | 0 |
| POST | /gam/blueprint/push | Push the ad units to GAM | 0.5/unit |
| GET | /gam/blueprint/size-bundles | List size bundles | 0 |
| POST | /gam/blueprint/size-bundles | Create a size bundle | 0 |
| DELETE | /gam/blueprint/size-bundles/{id} | Delete a size bundle | 0 |
| POST | /gam/blueprint/size-mappings | Create a size mapping | 0 |
| GET | /gam/blueprint/size-mappings/{ad_unit_id} | View an ad unit's mapping | 0 |
| PUT | /gam/blueprint/size-mappings/{ad_unit_id} | Update a size mapping | 0 |
| POST | /gam/blueprint/forecast | Available inventory forecast | 0 |
MCP tools
| Tool | Description | Credits |
|---|---|---|
| generate_inventory_blueprint | Generate a blueprint from a business template | 0 |
| push_blueprint_to_gam | Create the ad units in GAM | 0.5/unit |
| list_ad_units | List the network's ad units | 0 |
| get_ad_unit | Ad unit detail | 0 |
| create_ad_unit | Create an ad unit | 0.5 |
| update_ad_unit | Update an ad unit | 0 |
Examples
Generate a blueprint
{
"tool": "generate_inventory_blueprint",
"arguments": {
"template": "news_premium",
"brand": "acme_news",
"include_skin": true,
"include_interstitial": true
}
}Notes
- • 5 predefined templates: news, news_premium, ecommerce, blog, spa.
- • GAM naming validation: ^[a-z][a-z0-9_]{0,99}$.
- • Dry-run mode available (preview before commit).
- • Size bundles group IAB sizes by context (masthead, MPU, leaderboard).