Static addStatic addStatic createStatic createCreate a new Ad Campaign.
Optional data: objectThe Ad Campaign payload (JSON) to create
Optional params: Record<string, any>Optional query parameters
The newly created AdCampaign resource
Static createStatic createCreates a new Google Ads client account under a specified manager account. Corresponds to POST /ads/google/accounts/create
The creation payload.
ISO 4217 currency code.
The name for the new account.
The 10-digit MCC ID.
The UUID of the scheduler with auth tokens.
Time zone identifier (e.g., 'America/New_York').
The newly created Google Ads account details.
Static createStatic createCreate a new Ad Group (ad set) under a specific campaign.
The UUID of the parent Ad Campaign
Optional data: objectThe AdGroup creation payload
Optional params: Record<string, any>Optional query parameters
The newly created AdGroup resource
Static createStatic createCreate a new Ad Group Trigger.
The UUID of the parent Ad Campaign
The UUID of the Ad Group
Optional data: objectThe trigger creation payload
Optional params: Record<string, any>Optional query parameters
The newly created AdGroupTrigger resource
Static createStatic createStatic deleteStatic deleteDelete an Ad Campaign by ID.
The UUID of the campaign to delete
Optional params: Record<string, any>Optional query parameters
A 204 No Content response on success
Static deleteStatic deleteStatic deleteDelete an Ad Group (ad set) by ID, under a specific campaign.
The UUID of the parent Ad Campaign
The UUID of the AdGroup to delete
Optional params: Record<string, any>Optional query parameters
A 204 No Content response on success
Static deleteDelete an Ad Group Trigger by ID.
The UUID of the parent Ad Campaign
The UUID of the Ad Group
The UUID of the trigger
Optional params: Record<string, any>Optional query parameters
A 204 No Content response on success
Static deleteStatic deleteStatic enableStatic facebookStatic facebookStatic facebookStatic facebookStatic facebookStatic facebookStatic facebookStatic getGet performance metrics for individual ad creatives.
Optional params: { Optional community_Optional end_Optional limit?: numberOptional order?: "asc" | "desc"Optional platform?: stringOptional sort?: "spend" | "impressions" | "clicks" | "ctr" | "cpm" | "cpc"Optional start_Static getStatic getGET /ads/google/targeting/{resource_type}/{customer_id}/{resource_id}/settings
Static getStatic getCompare performance across platforms.
Optional params: { Optional community_Optional end_Optional start_Static getGet spend and delivery metrics over time.
Optional community_Optional group_Optional platform?: stringStatic getGet time-based performance metrics by hour and day of week.
Optional community_Optional platform?: stringStatic getStatic listList Ads (creatives).
Supports filtering by ad_group_id, social_media_post_id, operation_status, etc.
Optional params: Record<string, any>Optional query parameters for filtering/sorting
A paginated list of Ad resources
Static listList Ad Accounts for the given campaign ID, as defined by /ads/campaigns/{id}/ad_accounts on the backend.
E.g. for Reddit, you can pass ?business_id= to get business-level ad accounts, or for Twitter, it might just return a user’s ad accounts, etc.
The UUID of the Ad Campaign
Optional params: Record<string, any>Optional query parameters, e.g. business_id, page.size, etc.
A response object with data (ad account list)
Static listList platform-level businesses for the given campaign ID, as defined by /ads/campaigns/{id}/businesses on the backend.
Typically relevant for Reddit (list businesses), or might return a "not supported" message for Meta/TikTok.
The UUID of the Ad Campaign
Optional params: Record<string, any>Optional query parameters, e.g. page.size, etc.
A response object with data (business list or messages)
Static listList funding instruments for the given campaign ID, as defined by /ads/campaigns/{id}/funding_instruments on the backend.
For Twitter, pass ?account_id=... For Reddit, pass ?ad_account_id=... or ?business_id=...
The UUID of the Ad Campaign
Optional params: Record<string, any>Optional query parameters
A response object with data (funding instruments)
Static listList Ad Campaigns.
Example usage: Ads.listCampaigns({ community: 'uuid-of-community', platform: 'tiktok' })
Optional params: Record<string, any>Query parameters (e.g. community, platform, advertiser_id, etc.)
A paginated list of AdCampaign resources
Static listStatic listStatic listStatic listList Ad Groups (ad sets) for a specific campaign.
Example usage: Ads.listGroups('some-campaign-uuid', { promotion_type: 'WEBSITE' })
The UUID of the parent Ad Campaign
Optional params: Record<string, any>Optional query parameters (e.g. promotion_type, operation_status, etc.)
A paginated list of AdGroup resources
Static listStatic listStatic listStatic listStatic listStatic listStatic listStatic listList triggers defined for a given Ad Group.
The UUID of the parent Ad Campaign
The UUID of the Ad Group
Optional params: Record<string, any>Optional query parameters (pagination, etc.)
A paginated list of AdGroupTrigger resources
Static listStatic listStatic lookupStatic pauseStatic removeStatic searchStatic syncStatic syncSync an Ad Campaign with the remote platform
The UUID of the campaign to sync
Optional params: Record<string, any>Optional query parameters
The synced AdCampaign resource
Static syncDeep-sync a campaign tree (campaign → groups → ads) with its remote platform.
UUID of the campaign to sync
Optional params: Record<string, any>Optional query params
Fully-hydrated AdCampaign resource
Static syncSync an Ad Group with the remote platform
The UUID of the parent campaign
The UUID of the ad group to sync
Optional params: Record<string, any>Optional query parameters
The synced AdGroup resource
Static syncDeep-sync all the campaigns for a scheduler.
UUID of the campaign to sync
Optional params: Record<string, any>Optional query params
Fully-hydrated AdCampaign resource
Static tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokStatic tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static tiktokOptional data: objectOptional params: Record<string, any>Optional onUploadProgress: ((progressEvent) => void)Static twitterStatic twitterStatic updateUpdate an existing Ad by ID.
The UUID of the Ad to update
Optional data: objectThe partial or full Ad payload
Optional params: Record<string, any>Optional query parameters
The updated Ad resource
Static updateUpdate an existing Ad Campaign by ID.
The UUID of the campaign to update
Optional data: objectThe partial or full updated AdCampaign payload
Optional params: Record<string, any>Optional query parameters
The updated AdCampaign resource
Static updateStatic updateStatic updatePUT /ads/google/targeting/{resource_type}/{customer_id}/{resource_id}/settings
Static updateUpdate an Ad Group (ad set) by ID.
The UUID of the parent Ad Campaign
The UUID of the AdGroup to update
Optional data: objectUpdated fields for the AdGroup
Optional params: Record<string, any>Optional query parameters
The updated AdGroup resource
Static updateStatic updateUpdate an existing Ad Group Trigger by ID.
The UUID of the parent Ad Campaign
The UUID of the Ad Group
The UUID of the trigger to update
Optional data: objectUpdated trigger fields
Optional params: Record<string, any>Optional query parameters
The updated AdGroupTrigger resource
Static updateStatic viewStatic viewRetrieve a single Ad Campaign by ID.
The UUID of the campaign to fetch
Optional params: Record<string, any>Optional query parameters
The requested AdCampaign resource
Static viewStatic viewRetrieve a single Ad Group by ID, under a specific campaign.
The UUID of the parent Ad Campaign
The UUID of the AdGroup to fetch
Optional params: Record<string, any>Optional query parameters
The requested AdGroup resource
Static viewStatic viewRetrieve a single Ad Group Trigger by ID.
The UUID of the parent Ad Campaign
The UUID of the Ad Group
The UUID of the trigger
Optional params: Record<string, any>Optional query parameters
The requested AdGroupTrigger resource
Static viewGenerated using TypeDoc
POST /ads/google/targeting/campaigns/{customer_id}/{campaign_id}/locations