Adspirer icon

Adspirer

Manage ad campaigns across Google, Meta, LinkedIn & TikTok Ads via the Adspirer REST API

Actions119

Get Campaign Structure

AI-generated

Summary

Retrieve the structure of a Google Ads campaign, optionally filtered to a specific ad group, with pagination and inclusion options for detailed ad group data.

Inputs

  • Platform (required) — Select the advertising platform; for this operation, must be 'Google Ads'.
  • Campaign Id (required) — The Google Ads campaign ID whose structure you want to fetch.
  • Customer Id — The Google Ads customer ID associated with the campaign.
  • Ad Group Id — Optionally fetch only the details of this specific ad group, bypassing pagination.
  • Include — Specify what to include per ad group: 'all' (default) includes all nested data; 'summary' includes counts only without nested data; 'keywords' includes only keywords; 'ads' includes only ads.
  • Page — Page number for paginated ad groups (1-based). Leave blank to omit and retrieve the first page or all depending on API behavior.
  • Page Size — Number of ad groups per page (between 1 and 50). Leave blank to use default page size.

Output shape

a structured JSON object representing the campaign structure, including ad groups as specified by the parameters; if an Ad Group Id is specified, returns details for that ad group only.

Pagination applies only when no specific Ad Group Id is provided. The 'include' parameter controls the depth of information returned per ad group. The operation supports only the Google Ads platform.

Links

Discussion