ga4_google_ads_links
List Google Ads accounts connected to a GA4 property to view data sharing links and manage advertising integrations.
Instructions
Returns a list of links to Google Ads accounts for a GA4 property. Shows which Google Ads accounts are connected to the property for data sharing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| propertyId | Yes | The Google Analytics property ID. Accepted formats: '123456789' or 'properties/123456789' |
Implementation Reference
- src/tools/admin.ts:65-93 (handler)The main handler function listGoogleAdsLinks that implements the tool logic. It retrieves Google Ads links for a GA4 property by calling the Analytics Admin API, handles pagination, and returns a formatted response with the links array and total count.
export async function listGoogleAdsLinks(propertyId: string): Promise<ToolResponse> { try { const client = await getAnalyticsAdminClient(); const propertyName = constructPropertyResourceName(propertyId); const allLinks: unknown[] = []; let pageToken: string | undefined | null = undefined; do { const response: { data: GoogleAdsLinksResponse } = await client.properties.googleAdsLinks.list({ parent: propertyName, pageToken: pageToken || undefined, pageSize: 200, }); const data = response.data; if (data.googleAdsLinks) { allLinks.push(...data.googleAdsLinks); } pageToken = data.nextPageToken; } while (pageToken); return createSuccessResponse({ googleAdsLinks: allLinks, totalCount: allLinks.length, }); } catch (error) { return createErrorResponse(`Failed to list Google Ads links for ${propertyId}`, error); } } - src/tools/index.ts:54-67 (registration)Tool registration and schema definition for ga4_google_ads_links. Defines the tool name, description, and input schema requiring a propertyId parameter.
{ name: "ga4_google_ads_links", description: "Returns a list of links to Google Ads accounts for a GA4 property. Shows which Google Ads accounts are connected to the property for data sharing.", inputSchema: { type: "object" as const, properties: { propertyId: { type: "string", description: "The Google Analytics property ID. Accepted formats: '123456789' or 'properties/123456789'", }, }, required: ["propertyId"], }, }, - src/tools/index.ts:262-263 (registration)Tool routing that connects the ga4_google_ads_links tool name to its handler function listGoogleAdsLinks, extracting and casting the propertyId argument.
case "ga4_google_ads_links": return await listGoogleAdsLinks(args.propertyId as string);