Blueprint Change Set
Create an inventory change set, view the full diff, then push to GAM only after confirmation.
REST endpoints
| Method | Path | Description | Credits |
|---|---|---|---|
| POST | /api/inventory/blueprints/{id}/drafts | Create a change set scoped to a blueprint | 0 |
| GET | /api/inventory/blueprints/{id}/drafts/{did} | Read the change set | 0 |
| POST | /api/inventory/blueprints/{id}/drafts/{did}/promote | Promote the change set to the blueprint | 0 |
| POST | /api/inventory/blueprints/{id}/push | Push the blueprint to GAM with diff and network ack | 0.5/unit |
MCP tools
| Tool | Description | Credits |
|---|---|---|
| push_inventory_blueprint(dryRun=true) | Preview the CREATE/UPDATE/ARCHIVE diff and token | 0 |
| push_inventory_blueprint(confirmationToken=...) | Push the confirmed diff to GAM | 0.5/unit |
| generate_inventory_blueprint | Generate an inventory structure before the change set | 0 |
Examples
Preview then push a blueprint
{
"tool": "push_inventory_blueprint",
"arguments": { "blueprintId": "bp_a1b2", "dryRun": true }
}
// -> { "diff": { "create": 4, "update": 2, "archive": 1 }, "confirmationToken": "tok_7d4e" }
{
"tool": "push_inventory_blueprint",
"arguments": { "blueprintId": "bp_a1b2", "confirmationToken": "tok_7d4e", "dryRun": false }
}Notes
- • The dry-run does not create, modify or archive any ad unit.
- • Irreversible operations are listed in the plan.
- • The confirmed push keeps the expected network code in the plan context.