gam_admin
Configure and govern your GAM network by managing teams, users, sites, mobile apps, custom fields, labels, and publisher signals.
Instructions
GAM admin orchestration — 48 operations across 7 administrative areas: Teams, Sites, Mobile Apps, Custom Fields, Labels, Publisher Provided Signals, and Users.
MODE: mixed (read + write) AUTH: OAuth 2.0 required — user must have Network Admin role for write operations CREDITS: Reads = 0. Writes = 0.5 credits. OUTPUT: Returns administrative entity objects specific to the sub-area (Team, Site, MobileApp, CustomField, Label, PublisherProvidedSignalsConfig, User objects). SIDE EFFECTS: User management operations (deactivate, remove) affect access control. Label and custom field changes propagate to existing entities. Team changes affect inventory access rights. WHEN TO USE: Use gam_admin for network configuration and governance tasks (team structure, user management, custom metadata). Use targeting for custom targeting key-values used in ad serving.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Sub-operation to perform: • list_teams: List all teams on the network. Read-only. • get_team: Get a team by ID. Read-only. • create_team: Create a new team. Write. • update_team: Update a team's name or description. Write. • delete_team: Delete a team. Destructive write — removes team membership associations. • add_team_members: Add users to a team. Write. • remove_team_members: Remove users from a team. Write. • list_sites: List all sites on the network. Read-only. • get_site: Get a site by ID. Read-only. • create_site: Create a new site. Write. • update_site: Update a site. Write. • delete_site: Delete a site. Destructive write. • list_mobile_apps: List mobile apps registered on the network. Read-only. • get_mobile_app: Get a mobile app by ID. Read-only. • create_mobile_app: Register a new mobile app. Write. • update_mobile_app: Update a mobile app's details. Write. • list_custom_fields: List all custom fields defined on the network. Read-only. • get_custom_field: Get a custom field by ID. Read-only. • create_custom_field: Create a custom field for orders, line items, or creatives. Write. • update_custom_field: Update a custom field's name or options. Write. • deactivate_custom_field: Deactivate a custom field. Soft delete — preserves existing values. • list_custom_field_options: List options for a custom field of type SELECT. Read-only. • create_custom_field_option: Add a new option to a SELECT custom field. Write. • update_custom_field_option: Update a custom field option. Write. • deactivate_custom_field_option: Deactivate a custom field option. Write. • list_labels: List all labels. Read-only. • get_label: Get a label by ID. Read-only. • create_label: Create a new label. Write. • update_label: Update a label. Write. • deactivate_label: Deactivate a label. Write. • list_pps_configs: List Publisher Provided Signals configurations. Read-only. • get_pps_config: Get a PPS config by ID. Read-only. • create_pps_config: Create a PPS configuration. Write. • update_pps_config: Update a PPS configuration. Write. • delete_pps_config: Delete a PPS configuration. Destructive write. • list_users: List all users on the network. Read-only. • get_user: Get a user by ID. Read-only. • get_current_user: Get the currently authenticated user's profile. Read-only. • create_user: Create a new user account. Write. • update_user: Update a user's role or email. Write. • deactivate_user: Deactivate a user account. Write — revokes network access. • perform_user_action: Perform a lifecycle action on a user (ACTIVATE, DEACTIVATE). Write. • list_roles: List all roles available on the network. Read-only. • list_team_memberships: List team memberships for a user. Read-only. • get_user_record: Get a user's full record including role and team assignments. Read-only. • get_salesperson_record: Get salesperson metadata for a user. Read-only. • get_trafficker_record: Get trafficker metadata for a user. Read-only. • audit_user_access: Audit user access rights: roles, teams, and accessible inventory. 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. |