OrbiAds — Google Ad Manager

Get the GAM network configuration for the tenant. Returns the cached network info (network code, display name, ad units). If not initialized, returns None (agent should call switch_network/network_init).

Initialize or switch the GAM network context for the tenant. Verifies GAM connectivity and caches the network configuration (ad units, etc.). Use this if get_network_info returns None or to refresh the config.

List all GAM networks accessible with the tenant's credentials. Calls GET /v1/networks using the tenant's OAuth refresh token. Returns network code, display name, currency, and timezone for each.

List all advertisers in the tenant's GAM network.

Get a single advertiser by its ID.

List all Agencies (type=AGENCY) in the GAM network.

Create a new Agency company in GAM.

Create a new Advertiser company in GAM. Checks for an existing advertiser with the same name first. If found, returns the existing one with alreadyExisted=true instead of creating a duplicate.

Find an existing advertiser by exact name match in GAM. Searches all advertisers in the network and returns the first one whose name exactly matches the provided string. Returns NOT_FOUND if no match exists. Cost: 0.5 credits (deducted on call — no dry_run required for a search).

Find an existing advertiser by name, or create it if it doesn't exist. Combines search + creation in a single call. Ideal for end-to-end campaign setup workflows where the advertiser may or may not exist.

Find an existing order by name for a given advertiser, or create it if missing. Searches orders for the advertiser, returns the first match by name. If no match, creates a new order. Ideal for idempotent campaign setup.

List all delivering or delivering_slowly orders for a tenant. Queries GAM OrderService for orders with status DELIVERING or DELIVERING_SLOWLY. Returns basic details: id, name, status, start/end dates, advertiserId.

Fetch a single GAM Order by ID. Returns: id, name, status, advertiserId, agencyId, traffickerId, poNumber, notes.

List GAM Orders with optional name search and pagination. Returns: items (list of order dicts), total, offset, limit. Each order has: id, name, status, advertiserId, traffickerId, poNumber, notes.

Create a new GAM Order. An Order is the container for Line Items. It belongs to an Advertiser. The traffickerId is automatically set to the current authenticated user. When check_existing=True (default), searches for an order with the same name and advertiser before creating....

Archive a GAM Order via performOrderAction(ArchiveOrders). Archiving hides the order and all its line items from active views. The order remains queryable but stops serving. Cannot be undone easily.

Approve a GAM Order (transitions it to APPROVED status). Approving an Order also approves all eligible Line Items within it, allowing them to start delivering when their start date is reached.

Pre-launch verification of an entire Order and all its Line Items. Runs verify_line_item_setup on each LI attached to the order. Returns aggregate pass/fail with per-LI details.

Update an existing GAM Order. Uses read-modify-write: fetches the order, applies updates, and saves. Supported fields: name, poNumber, notes, traffickerId, startDateTime, endDateTime, totalBudget.

List GAM contacts, optionally filtered by company. Returns: list of contacts with id, name, companyId, email.

Create a GAM Contact associated with a Company/Advertiser. Contacts can be attached to Orders for billing and communication purposes.

Create Line Items for a deployed job. Requires the job to have targeting configured in Firestore. Creates Line Items (one per Ad Unit).

Activate all Line Items for a job (PAUSED -> DELIVERING).

Pause all Line Items for a job (DELIVERING -> PAUSED).

Get a single line item by ID.

Update a specific Line Item (e.g., changes to targeting, dates, or status).

List Line Items belonging to a specific Order. Returns details: id, name, status, stats, goals, etc. Supports pagination via offset and limit parameters.

Duplicate a Line Item in Google Ad Manager. Fetches the full line item configuration, creates a copy with ' - Copy' appended to the name, and applies any provided overrides. The duplicate always starts in DRAFT status.

Archive a Line Item in Google Ad Manager. GAM does not delete Line Items — archiving removes them from active views. Archived items can still be queried but won't serve ads.

Pre-launch verification of a Line Item's readiness. Checks: creative associations exist, targeting is set, dates are valid, goal > 0. Returns a pass/fail report with actionable messages.

Approve a Line Item in GAM (transitions from DRAFT/NEEDS_CREATIVES to READY). Note: Line Items typically auto-approve when their parent Order is approved. Use this for individual LI approval when needed.

Create an AdExchange (programmatic) Line Item with floor CPM targeting. currency_code, delivery_rate_type, and creative_rotation_type fall back to tenant delivery defaults (configurable via update_delivery_defaults) when not provided.

Create an Open Bidding (Exchange Bidding) Line Item with floor CPM. Open Bidding line items use lineItemType=AD_EXCHANGE with a floor CPM. Demand partners bid in real-time above the floor; delivery is not guaranteed.

List Private Deals (PMP) available in the GAM network. Returns deal IDs, names, types and statuses. Use the returned Id as deal_id when calling create_preferred_deal_line_item. Note: requires a live network — may return UNEXECUTABLE on test networks.

Update targeting on an existing Line Item (custom, geo, day-part targeting). Modifiable post-creation: customTargeting, geoTargeting, dayPartTargeting. Ad unit targeting is locked after line item creation.

Create a Preferred Deal (PMP non-guaranteed) Line Item linked to a private deal ID. Requires Deal Manager to be disabled on the network (direct flow). Use list_private_deals to retrieve valid deal IDs before calling this tool. The line item is created with: - lineItemType = PR...

List all creatives associated with a specific advertiser.

[DEPRECATED] Upload a standalone image asset to Google Ad Manager. CreativeAssetService is unavailable in the supported GAM SOAP version. Use create_image_creative instead — it uploads and creates the creative in one step.

Associate a creative with a Line Item in Google Ad Manager (create LICA). Links the specified creative to the Line Item so ads can serve. Returns the created LICA ID(s).

Update a creative in Google Ad Manager (read-modify-write). Modify any property: name, destinationUrl, snippet, tracking URLs, size, status. For tracking: add/replace thirdPartyImpressionTrackingUrls (pixel URLs for IAS, MOAT, DoubleVerify, DCM), thirdPartyClickTrackingUrl (Ht...

List all creatives associated with a specific line item. Uses LICA service to find associations, then Creative service to fetch details.

Fetch details for a single creative by ID.

Generate a GAM creative preview URL for testing on a real site. Opens the specified site with the ad injected for visual verification, without affecting delivery statistics. Perfect for client sign-off.

Generate preview URLs for multiple Line Item / Creative pairs in one call. Each pair can have its own site_url; falls back to default_site_url. Soft-fail per pair: a failed URL returns {error: ...} instead of failing the whole call. Returns: previewLinks list with label, lineI...

Upload a creative image and associate it with a Line Item in one step. Performs three operations in sequence: 1. create_image_creative — uploads image bytes inline + creates the ImageCreative in GAM. 2. create_lica — links the creativeId to the line_item_id so ads can serve. T...

Upload multiple creative images with per-file sizes, names and click URLs. REQUIRED per file: file_path, width, height, destination_url. Each file can have its own name/destination_url override. The creative name follows the tenant naming convention (creative_template) if conf...

Create a ThirdPartyCreative in GAM for external ad tags. Use this for custom HTML/JS tags from third-party ad servers (DV360, TTD, etc.). Distinct from create_html5_creative which is for self-contained HTML5 ads. Supports native third-party impression tracking (IAS, MOAT, DV,...

Create a VAST VideoRedirectCreative in GAM. Supports native video event tracking (VAST pixels) for IAS, MOAT, DoubleVerify, DCM, etc. Use tracking_urls to attach pixels to specific VAST events (impression, quartiles, complete).

Create an Html5Creative in GAM from an HTML snippet. The HTML content is automatically packaged into a ZIP bundle and uploaded as an Html5Creative (not a ThirdPartyCreative). For 3rd-party tags, use create_third_party_creative instead. IMPORTANT: For HTML5 creatives, the click...

Upload a pre-built HTML5 ZIP bundle as an Html5Creative in GAM. Use this when the studio delivers a ready-made ZIP file. For an inline HTML snippet, use create_html5_creative instead. IMPORTANT: The click-through URL must be embedded in the HTML/JS inside the ZIP. There is no...

Compress an oversized image creative to meet GAM's 1 MB limit. Uses PIL/Pillow to progressively reduce JPEG quality via binary search until the output fits within target_kb. GIF files are converted to PNG first. Output: written next to the original as {stem}_compressed.jpg (or...

List all LICA associations (Line Item Creative Associations) for a Line Item. Returns raw LICA objects with id, lineItemId, creativeId, status, and sizes. Use list_creatives_by_line_item to get enriched Creative details instead.

Fetch LICA associations for multiple Line Items in a single batch call. Returns a dict mapping lineItemId (str) to a list of LICA objects. More efficient than calling get_licas_by_line_item repeatedly.

Deactivate a LICA (Line Item Creative Association) in GAM. Removes the association between a creative and a line item so the creative stops serving on that line item. The LICA can be re-activated later.

Delete LICAs (Line Item Creative Associations) from GAM. Permanently removes creative associations from a line item. Use get_licas_by_line_item to find LICA IDs first. WARNING: This action cannot be undone.

Create a VAST AudioCreative in GAM.

Search all creatives in the GAM network by name. Returns: items (list of creative dicts), total, offset, limit. Each creative has id, name, advertiserId, size, creativeType, status.

Archive (deactivate) a creative in GAM. Archived creatives no longer serve traffic but are not deleted. This action can be reversed by reactivating the creative in GAM UI.

List NativeStyles in the GAM network with optional name filter.

Fetch a single NativeStyle by ID, including HTML/CSS snippets and fluid settings.

Update a NativeStyle's HTML, CSS, name, or size settings.

Archive a NativeStyle so it stops serving.

Create an ImageCreative in GAM from a local image file. Reads the image file and uploads it inline via CreativeService (no separate upload step). Supports standard IAB display sizes (banner, MPU, billboard, etc.). Supported formats: PNG, JPG, GIF, SVG. Supports native third-pa...

Create an Html5Creative in GAM from individual files or a pre-built ZIP bundle. Accepts either: - A pre-built ZIP bundle via zip_path, OR - Individual files: html_path (required) + optional css_path + optional image_path When individual files are provided, they are automatical...

Ensure the Classic Native Template exists for this tenant, creating it if needed. The Classic Native Template is a USER_DEFINED native GAM template with 7 variable slots: - headline (STRING, required) - click_url (URL, required) - main_image (ASSET/IMAGE, required) - body (STR...

Create a Classic Native creative in GAM (TemplateCreative over the Classic Native Template). This creative type combines a headline, body text, CTA, a main image, and an optional logo into a native ad that renders using the per-tenant Classic Native Template. The Classic Nativ...

List CreativeTemplates in the GAM network with their variable definitions. Returns all USER_DEFINED templates, with full variable metadata per template (label, uniqueName, isRequired, type, defaultValue/mimeTypes).

Fetch a single CreativeTemplate by ID with all variable definitions and snippet. Returns full template details including all variable slots with their types, default values, required flags, and the raw HTML snippet if present.

Check the real-time delivery status of a job's line items. Returns the aggregated lifecycle status (DELIVERING, READY, etc.) and per-line-item statuses.

Fetch a delivery report for the job (Impressions, Clicks, CTR). Returns a list of rows (one per Line Item). Uses Firestore cache when available.

Run a dynamic GAM report with any dimensions and metrics. Costs 0.5 credits. Submits the report job to GAM REST v1 (or SOAP if api='soap'), polls until ready (up to ~100 seconds), then caches and returns results. Response structure: - rows: first 200 rows inline - totalRows: t...

Fetch an inventory report: ad requests, impressions, fill rate per ad unit. Costs 0.5 credits. Defaults to LAST_MONTH if no dates are provided.

Retrieve a previously cached report result without re-running the report. Free tool — no credit cost. Results expire after 30 days. Returns the full result including ALL rows, summary totals, metadata, and the GAM API resource reference (gamResultRef).

Export a report as CSV, TSV, XLSX, or XML. Costs 0.5 credits. Uses FIXED date range. For api='rest': returns {csv, rowCount, resultId}. Always CSV format. For api='soap' with text formats (CSV_DUMP, TSV, TSV_EXCEL): returns {csv, rowCount}. CSV string with appropriate delimite...

List all documented GAM report dimensions with category and description. Returns list of {name, category, description, api}. Any valid GAM dimension string can be used in run_custom_report even if not listed here. Categories: time, line_item, order, advertiser, creative, inven...

List all documented GAM report metrics with category and description. Returns list of {name, category, description, api}. Any valid GAM metric string can be used in run_custom_report even if not listed here. Categories: ad_server, viewability, inventory, total, adsense, adx, p...

List supported relative date range values for date_range_type parameter.

No parameter schema in public metadata yet.

Get an availability forecast for arbitrary targeting without an existing job. Returns: availableUnits, matchedUnits, deliveredUnits, utilizationPercent, contendingLineItems, recommendation (with riskLevel).

Get an availability forecast for an existing Line Item. Returns: availableUnits, forecastUnits, possibleUnits, unitType, lineItemId.

List all saved report templates (built-in + custom). Built-in templates are seeded on first call: - GAM: monthly performance, by advertiser, inventory, viewability - GA4: monthly traffic, performance by country (if GA4 configured) Use run_report_from_template with any template...