Google Ads Audiences: Sync Audience Members

Append or replace Google Customer Match members with local hashing, batching, and invalid-row reporting.

Tool ID: google_ads_audiences_sync_audience_members

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'google_ads_audiences_sync_audience_members',
  {
    "account_id": "123456789",
    "audience_id": "audience_123",
    "rows": [
      {
        "email": "jane.doe@example.com",
        "email_sha256": "jane.doe@example.comxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "phone": "+14155550123"
      }
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute google_ads_audiences_sync_audience_members --input '{
  "account_id": "123456789",
  "audience_id": "audience_123",
  "rows": [
    {
      "email": "jane.doe@example.com",
      "email_sha256": "jane.doe@example.comxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "phone": "+14155550123"
    }
  ]
}' --json

Example response

The SDK exposes this shape at result.toolResponse.raw. Values below are representative.

{
  "data": {
    "audience_id": "audience_123",
    "mode": "append",
    "uploaded_count": 123,
    "invalid_count": 123,
    "invalid_rows": [
      {
        "originalIndex": 123,
        "reason": "example"
      }
    ],
    "request_ids": [
      "request_123"
    ]
  }
}

Use deepline tools get google_ads_audiences_sync_audience_members --json for the latest machine-readable contract.

Input reference

Name	Type	Required	Default	Details
`payload.account_id`	`string`	Yes	—	Data Manager account ID (e.g. Google Ads customer ID, no formatting). Minimum length: 1.
`payload.account_type`	`"GOOGLE_ADS" \| "DISPLAY_VIDEO_PARTNER" \| "DISPLAY_VIDEO_ADVERTISER" \| "DATA_PARTNER" \| "GOOGLE_ANALYTICS_PROPERTY" \| "GOOGLE_AD_MANAGER_AUDIENCE_LINK"`	No	`"GOOGLE_ADS"`	Allowed: `GOOGLE_ADS`, `DISPLAY_VIDEO_PARTNER`, `DISPLAY_VIDEO_ADVERTISER`, `DATA_PARTNER`, `GOOGLE_ANALYTICS_PROPERTY`, `GOOGLE_AD_MANAGER_AUDIENCE_LINK`.
`payload.login_account_id`	`string`	No	—	Optional manager-account ID used as the login account when the token belongs to an MCC user. Minimum length: 1.
`payload.login_account_type`	`"GOOGLE_ADS" \| "DISPLAY_VIDEO_PARTNER" \| "DISPLAY_VIDEO_ADVERTISER" \| "DATA_PARTNER" \| "GOOGLE_ANALYTICS_PROPERTY" \| "GOOGLE_AD_MANAGER_AUDIENCE_LINK"`	No	—	Allowed: `GOOGLE_ADS`, `DISPLAY_VIDEO_PARTNER`, `DISPLAY_VIDEO_ADVERTISER`, `DATA_PARTNER`, `GOOGLE_ANALYTICS_PROPERTY`, `GOOGLE_AD_MANAGER_AUDIENCE_LINK`.
`payload.audience_id`	`string`	Yes	—	Minimum length: 1.
`payload.mode`	`"append" \| "replace"`	No	`"append"`	Allowed: `append`, `replace`.
`payload.rows`	`array`	Yes	—	Audience member rows to upload. Most platforms accept much smaller per-request batches, so Deepline automatically chunks requests. Minimum items: 1. Maximum items: 300000.
`payload.consent`	`object`	No	—	—
`payload.encoding`	`"HEX" \| "BASE64"`	No	`"HEX"`	Allowed: `HEX`, `BASE64`.
`payload.validate_only`	`boolean`	No	`false`	—
`payload.terms_of_service_accepted`	`boolean`	No	`true`	—

Output reference

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	—
`result.data.audience_id`	`string`	Yes	—	—
`result.data.mode`	`"append" \| "replace"`	Yes	—	Allowed: `append`, `replace`.
`result.data.uploaded_count`	`integer`	Yes	—	Minimum: 0.
`result.data.invalid_count`	`integer`	Yes	—	Minimum: 0.
`result.data.invalid_rows`	`array`	Yes	—	—
`result.data.invalid_rows[].originalIndex`	`integer`	Yes	—	Minimum: 0.
`result.data.invalid_rows[].reason`	`string`	Yes	—	—
`result.data.request_ids`	`array`	Yes	—	—
`result.meta`	`record`	No	—	—

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.

Getting Started

GTM is code

Features

Deepline SDK beta

Integrations

API Reference

Google Ads Audiences: Sync Audience Members

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation