Docs / Capability guide
Publishers, apps, placements and domains
Create publishers and placements, then check how ad requests find them.
All capabilities · Related guide · Agent prompt for this capability
When to use this example
Before adding a site's ad tags, you need to know which publisher owns each placement and which public IDs the requests should carry. An inventory export also helps compare an imported batch with the setup you intended.
What the example gives you
The workspace inspector saves publisher and placement records as JSON, following list pagination. It gives you configuration to review before tagging a site; creating inventory and connecting demand are separate steps in the guide.
Before you start
A sandbox tenant, a tenant-scoped API key, and a publisher. Publisher-portal keys use the publisher-scoped API instead of tenant-wide inventory.
Run the example
Extract the archive and follow README.md for setup, commands, and expected results. Start with workspace_inspect.py. Local tests use sample data.
Python tools accept --help. To connect to your workspace, supply the deployment URLs, credentials and resource IDs required by the tool.
Connect it to your application
Create a publisher with a stable public_id, then a placement with its own public_id under that publisher. Select the media type and set the floor as a decimal. Complete demand and creative setup before sending traffic.
For app supply, create an app and associate it with the placement; for web inventory, import or create inventory domains. Inspect import failures before publishing changes.
List publishers and placements with workspace_inspect.py. Follow opaque next_cursor values; save the returned resource IDs. Generate a tag from the publisher guide and probe only your sandbox placement.
Check the result
The placement resolves to the expected publisher and media type. Check missing and paused placements for the expected no-fill or error response. A placement needs eligible demand and creatives to fill.