blueprint
Define and manage your Google Ad Manager inventory blueprint including ad formats, positions, key-values, and brand settings to standardize campaign generation.
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).
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. |