Associate a label to an audience data segment/user list in the API

[Ben Usher]

Hi,

I can associate a label with an audience data segment/user list in the Ads UI but I can't find the mechanism to do this in the API.

We have used CustomerLabel to associate labels with customers, but there does not seem a UserListLabel (or similar) resource to associate a label to a segment. What is the correct way to do this through the API?

Thanks,

Ben

[Google Ads API Forum Advisor]

Hi Ben,

Thank you for raising this concern to the Google Ads API Forum. To have a clearer view of this concern, could you please provide the screenshot of the Google Ads UI where we can see this feature that you are referring to, so we can give an accurate answer? 

If there's any personal identifiable information, you can provide it via the Reply privately to author option. If this option is not available, then send it instead on this email address googleadsapi-support@google.com.

Best regards,

Jinky Google Ads API Team

ref:_00D1U1174p._5004Q2evKLk:ref

[Ben Usher]

Hi Jinky,

Please find attached a screenshot of adding a label to an audience segment in the UI.I can't see a way to associate and view the labels for a segment when I use the API. Is it possible?

Thanks,

Ben

On Friday, 30 September 2022 at 18:09:29 UTC+1 adsapi wrote:

Hi Ben,

Thank you for raising this concern to the Google Ads API Forum. To have a clearer view of this concern, could you please provide the screenshot of the Google Ads UI where we can see this feature that you are referring to, so we can give an accurate answer? 

If there's any personal identifiable information, you can provide it via the Reply privately to author option. If this option is not available, then send it instead on this email address googleadsa...@google.com.

[Google Ads API Forum Advisor]

Hi Ben,

Thank you for providing the screenshot. You may try the ad_group_audience_view attribute resources and once you get the following fields, you may use separate report label to get full details about that label by filtering using resource name of label. 

1. ad_group.labels
2. ad_group_criterion.labels
3. campaign.labels

Let me know if this works for you.

[Ben Usher]

Hi Jinky,

Thanks for your response, but I'm afraid that's not quite what I'm looking for. The segment I've created belongs to an account/customer and is not yet applied to an ad group or campaign.

What I think I need is something like a UserListLabel service (similar to the CustomerLabel Service) that let's me associate a label with an audience segment/user list. Below is a screenshot of another way I can associate a label with a user list in the UI. What is the correct way to create a link between a label and a user list using the API?

Thanks,

Ben

[Google Ads API Forum Advisor]

Hi Ben,

Thank you for your response and for the attached screenshot.

Upon checking, below are the label relevant services that are currently supported in the Google Ads API :

• AdGroupAdLabelService
• AdGroupCriterionLabelService
• AdGroupLabelService
• CampaignLabelService
• CustomerLabelService
• LabelService

That said, there appears to be no service at this time that is dedicated to attaching labels to UserList resources. The closest service that can be used would be the AdGroupCriterionLabelService, and when using it to attach a label to a user list when used as an ad group criterion.

Since this feature is already available in the Google Ads UI and for our team to create a feature request, subject for review, could you also share to our team your complete or additional use case(s) so we can pass this along in the request?

Best regards,

Peter Laurence Google Ads API Team

ref:_00D1U1174p._5004Q2evKLk:ref