blueprint
Define and update the canonical inventory structure for GAM campaigns, including ad formats, positions, custom targeting, and brand settings.
Instructions
Manage the tenant inventory blueprint — the canonical definition of ad formats, positions, key-values, and brand settings used to generate GAM campaigns.
MODE: mixed (read + write) AUTH: OAuth 2.0 required CREDITS: Reads = 0. Writes (save_blueprint, save_preferences, add/remove operations) = 0 credits but modify persistent tenant configuration. OUTPUT: get_active_blueprint returns the full blueprint JSON with formats, positions, keyValues, brand. list_templates returns available campaign templates. SIDE EFFECTS: Changes to the blueprint affect all future campaign deployments that reference it. Removing a format or position does not remove existing GAM line items. WHEN TO USE: Use blueprint to define or update the standard inventory structure before running campaign. Use formats tool for the Custom Format Registry (creative format recipes, not inventory positions).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "blueprint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Sub-operation to perform: • get_active_preferences: Read the current tenant preferences (naming conventions, default targeting, delivery settings). • get_active_blueprint: Read the full active inventory blueprint JSON. • save_blueprint: Replace the full blueprint with a new version. Write. Validate with a dry-run before saving to production. • save_preferences: Update tenant preferences. Write. • add_format: Add a creative format to the blueprint. Write. Requires format_code and size parameters. • remove_format: Remove a creative format from the blueprint. Write. Does not remove existing GAM creatives. • add_position: Add an inventory position (ad unit + targeting combination) to the blueprint. Write. • remove_position: Remove an inventory position from the blueprint. Write. Does not archive existing ad units. • add_key_value: Add a custom targeting key-value definition to the blueprint. Write. • remove_key_value: Remove a key-value definition from the blueprint. Write. • update_brand: Update brand metadata (name, logo, primary color) attached to the blueprint. Write. • update_platforms: Update the list of target platforms (desktop, mobile_web, app_ios, app_android) in the blueprint. Write. • list_templates: List all available campaign templates (display, native, video presets). Read-only. | |
| network_code | No | GAM network code (e.g. 12345678). Required for all network-scoped operations. Obtain via select_gam_network or list_accessible_networks. |