Skip to main content
Google Ad Manager logo

Overview

Add Google Ad Manager to any ModuleX agent or workflow. Programmatic advertising platform for managing ad inventory, reporting, and campaign delivery via the Google Ad Manager REST API (admanager.googleapis.com/v1).
Categories: Marketing & Advertising · Advertising · Marketing · Auth: OAuth2 · Actions: 2

Authentication

OAuth2 Authentication

Connect using Google OAuth (recommended)

Required Credentials

FieldDescriptionRequiredFormat
Client IDGoogle OAuth App Client IDYes-
Client SecretGoogle OAuth App Client SecretYes-

OAuth Configuration

  • Authorization URL: https://accounts.google.com/o/oauth2/v2/auth
  • Token URL: https://oauth2.googleapis.com/token
  • Scopes: https://www.googleapis.com/auth/admanager

Available Actions

Parameters

parent
string
required
The parent resource where this Report will be created. Format: networks/{networkCode}
name
string
required
Identifier. The resource name of the report. Format: networks/{networkCode}/reports/{reportId}
visibility
string
required
The visibility of the report. Allowed values: HIDDEN, DRAFT, SAVED
dimensions
array
required
The list of dimension identifiers to report on
metrics
array
required
The list of metric identifiers to report on
report_type
string
required
The type of this report. Allowed values: REPORT_TYPE_UNSPECIFIED, HISTORICAL
date_range
string
required
The date range type of this report. Allowed values: fixed, relative
display_name
string
The display name of the report
schedule_options
object
The options for a scheduled report (ScheduleOptions schema)
filters
array
The filters for this report. Each element is a JSON object conforming to the Filter schema
time_zone
string
The time zone for the date range (IANA format). Defaults to publisher time zone
currency_code
string
ISO 4217 currency code. Defaults to publisher currency code
custom_dimension_key_ids
array
Custom Dimension keys for CUSTOM_DIMENSION_* dimensions
line_item_custom_field_ids
array
Custom field IDs for LINE_ITEM_CUSTOM_FIELD_* dimensions
order_custom_field_ids
array
Custom field IDs for ORDER_CUSTOM_FIELD_* dimensions
creative_custom_field_ids
array
Custom field IDs for CREATIVE_CUSTOM_FIELD_* dimensions
time_period_column
string
Time period column for comparison. Allowed values: TIME_PERIOD_COLUMN_UNSPECIFIED, TIME_PERIOD_COLUMN_DATE, TIME_PERIOD_COLUMN_WEEK, TIME_PERIOD_COLUMN_MONTH, TIME_PERIOD_COLUMN_QUARTER
flags
array
List of flags for this report (Flag schema objects)
sorts
array
Default sorts for this report (Sort schema objects)
start_date_year
integer
Year of the start date (1-9999). Required when date_range is ‘fixed’
start_date_month
integer
Month of the start date (1-12). Required when date_range is ‘fixed’
start_date_day
integer
Day of the start date (1-31). Required when date_range is ‘fixed’
end_date_year
integer
Year of the end date (1-9999). Required when date_range is ‘fixed’
end_date_month
integer
Month of the end date (1-12). Required when date_range is ‘fixed’
end_date_day
integer
Day of the end date (1-31). Required when date_range is ‘fixed’
relative
string
Relative date range identifier (e.g. TODAY, YESTERDAY, LAST_7_DAYS). Required when date_range is ‘relative’
comparison_date_range
string
Comparison date range type. Allowed values: fixed, relative
comparison_start_date_year
integer
Year of comparison start date. Required when comparison_date_range is ‘fixed’
comparison_start_date_month
integer
Month of comparison start date. Required when comparison_date_range is ‘fixed’
comparison_start_date_day
integer
Day of comparison start date. Required when comparison_date_range is ‘fixed’
comparison_end_date_year
integer
Year of comparison end date. Required when comparison_date_range is ‘fixed’
comparison_end_date_month
integer
Month of comparison end date. Required when comparison_date_range is ‘fixed’
comparison_end_date_day
integer
Day of comparison end date. Required when comparison_date_range is ‘fixed’
comparison_relative
string
Relative comparison date range identifier (e.g. PREVIOUS_PERIOD, SAME_PERIOD_PREVIOUS_YEAR). Required when comparison_date_range is ‘relative’

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateReportOutput",
  "type": "object"
}

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "networks": {
      "items": {
        "type": "string"
      },
      "title": "Networks",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListNetworkOptionsOutput",
  "type": "object"
}

Limits & Quotas

  • Google Ad Manager API enforces per-network rate limits; consult your network’s quota settings in the Ad Manager UI.
  • Standard quota: 10,000 requests per day per project (default; can be increased via Google Cloud console).
  • Error model: non-2xx responses and timeouts are caught and returned as success=False + error rather than raising.

Ahrefs

Google My Business

Google Search Console