Google Ads

Adds or removes contacts from a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. Note: It takes 6 to 12 hours for changes to be reflected in the customer list. Email addresses must comply with Google Ads policies and applicable privacy/consent laws. Requires an existing Google-approved Customer Match upload integration; new integrations should use Data Manager audience ingestion instead.

Create, update, remove, or act on supported Google Ads resource types in one request. With partial_failure=false (the default), all operations are atomic and execute only if every operation is valid. With partial_failure=true, valid operations execute independently while invalid operations return errors. Use negative temporary resource IDs to connect resources created in the same request. Remove operations are destructive.

Create an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field_type CALLOUT. Cleanup removes that association; Google does not allow deleting the asset.

Create a new Google Ads client under an eligible direct parent manager. Requires a manager account, not an advertiser client account. Currency and time zone cannot be changed after creation. Set validate_only=true to check eligibility and parameters without account creation. Invitation fields require Google allowlisting.

Creates a Google Ads customer list (UserList/audience/remarketing list), not a Google Ads customer account. Note: Requires an authenticated Google Ads connection with customer_id configured. Email-based lists must comply with Google Ads policies and applicable privacy/consent laws. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation.

Create a Data Manager user list, or validate without creating one.

Create the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.

Create all arms for a Google Ads experiment in one required atomic batch.

Delete a Data Manager user list, optionally validating only.

Immediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment's end date to now.

Forecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.

Retrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.