Clarification on API Support for Creating Specific Audience Segments

[Amit Tomar]

Hello Team,

I would like to confirm the API support for creating the following audience segment types:

1. App Users Segment – Is API support available to create this type of segment? If yes, please share the relevant documentation or sample code.

2. Google Analytics Segment – Is API support available to create Google Analytics-based audience segments via the API? If yes, please provide any official documentation or sample code.

3. Customer List Segment –

   • I understand API support exists for creating customer list audiences, but I want to confirm if all the available data source options in the UI are supported via API as well:

     • Select an existing source

     • Connect a new data source

     • Upload a file manually

     • Skip this step and set up a data source later

   • If yes, please share documentation or example code for each of these data source methods.

Thank you for your assistance.

[Google Ads API and AdWords API Forum]

Hi,

Thank you for reaching out to the Google Ads API support team. 

Please find the answers for your questions below: 

1. App Users Segment – Is API support available to create this type of segment? If yes, please share the relevant documentation or sample code.

• Kindly note that creating the 'App Users" audience segment type is not supported using the Google Ads API. I will raise a request to add this feature to be available in the Google Ads API. We cannot provide a scheduled timeline for the availability of this feature in the Google Ads API. I would recommend you to follow our Release Notes and Blog Post for future updates.

2. Google Analytics Segment – Is API support available to create Google Analytics-based audience segments via the API? If yes, please provide any official documentation or sample code.

• There is no service to support importing Google Analytics created remarketing audiences to Google Ads in the API.

3. Customer List Segment 

• For creating the customer list using the Google Ads API, you don't need to select data source as the uploads using the Google Ads API don't require any manual file uploads. I would recommend you to refer to this documentation on how to create the customer list segment using the Google Ads API. For uploading the user data you need to follow this usage flow guide as it explains you in detail on how to upload the users to the customer list using the Google Ads API. 
  

[Amit Tomar]

Hi,

Thanks for your support. I have a few more clarifications:

1. Retrieving Additional Columns from Audience Manager (API level)

In the Google Ads UI → Audience Manager, I can see additional columns such as:

• Size: YouTube

• Size: Gmail campaign

• Creation date

• Source

• Usage status

When querying via the API, fields like user_list.size_for_youtube or user_list.size_for_gmail are not recognized in v21. Could you please confirm:

• The correct API resource and field names to retrieve these columns.

• If some of these are not available via API, any alternate way to fetch them.

2. Data Source Options for Customer List Audience Creation
While creating a Customer List Audience in the UI, under Data source, there are options for:

• Select an existing source

• Connect a new data source

• Upload a file manually

Could you confirm if "select existing source" and "connect new data source" options are available at API level, and if yes, please share documentation or sample requests.

Attaching screenshots for reference.

Thanks & Regards,
Amit Tomar

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

Kindly note that currently there is no resource or field in the Google Ads API to retrieve the user_list.size_for_youtube or user_list.size_for_gmail via the Google Ads API. As this feature is available in the UI, I will raise a feature request to access user_list.size_for_youtube or user_list.size_for_gmail data via the Google Ads API. However, I cannot provide a scheduled timeline for its availability. I would recommend monitoring our Blog Post and Release Notes for updates regarding future changes.

Regarding customer lists via the API: Account owners or administrators can use the Google Ads API to upload data files and manage Customer Match segments. Advertisers can upload a data file, add or remove customer data, or edit configurations through the API. For more information, visit the data section of the Google Ads API documentation. OfflineUserDataJobService and UserDataService are the services used for uploading customer match list data. Please refer to the suggested documentation for step-by-step guidance on how to programmatically manage customer match lists via the API.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-08-13 21:03:19Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01sz0GQ:ref" (ADR-00329845)