best practices for adding users to an audience list for a large list

[andryushka x]

Hi -

I am developing a something which will add users to a UserList. Something like this:

        add_emails_op = {

            "operand": {"userListId": list_id, "membersList": members},

            "operator": "ADD",

        }

        return list_service.mutateMembers([add_emails_op])

The number of users (aka "members" in the above code) is  ~1 million.

First of all is there a maximum number of users which can be added in a single mutateMembers call? And even if there isn't, is there a best practices for perhaps doing the mutate in parts?

Thank you!

[Google Ads API Forum Advisor Prod]

Hello,

I understand that you are trying to upload up to 1 million members into the user list. A user list can hold up to 500000 members only as per the below link. So you have to split them into 2 user lists.  You can include all members using a single operation. Also, please refer the customer match considerations mentioned below while uploading members. Please let me know if you have any further questions.

Member list URL: https://developers.google.com/adwords/api/docs/reference/v201809/AdwordsUserListService.MutateMembersOperand.html
Customer match considerations: https://developers.google.com/adwords/api/docs/guides/remarketing#customer_match_considerations

Regards,
Sai Teja, Google Ads API Team

ref:_00D1U1174p._5001UKNOIZ:ref

[andryushka x]

Hi Sai -- 

A little confused by your answer -- when I read the documentation, it seems more like the operand can only hold 500K users, which implies that with one mutateMembers operation you can only add 500K members, but you can't you just run the mutateMembers operation twice on the same UserList to get 1 user list with 1 million users?

[Google Ads API Forum Advisor Prod]

Hello,

Your understanding is right, I meant that maximum limit for user list is 500K members only and all the 500K can be added in a single operation for a single user list. As one user list can hold only 500k members for your scenario you need 2 user lists there fore 2 API calls. Hope this clears, please let me know if you have any further questions.