RE: How do I create an audience using the new Google Ads API?

[googleadsapi-forumadvisor via AdWords API and Google Ads API Forum]

Hi Jon,

Sure, I have passed this to our team.

Regards,
Dhanya, Google Ads API Team
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog and discussion group:
http://googleadsdeveloper.blogspot.com/search/label/adwords_api
https://developers.google.com/adwords/api/community/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups "AdWords API and Google Ads API Forum" group.

To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/00d12js9tg0185gk5u00511bqow6kmjcc9o64o30c1g68q3ee9m%40mail.gmail.com.
For more options, visit https://groups.google.com/d/optout.

Re: How do I create an audience using the new Google Ads API?

[Jon Oler]

Thanks again for the response, Dhanya. I now have my answer. 

I realize that the new API is in beta and that the full API that includes 
all the functionality of the old SOAP API is supposed to be released this 
quarter. That said, I feel like both the API docs and the release notes 
could be clearer on this point. 

As I mentioned earlier, the release notes just state that as of version 
0.6.0, this functionality was added to the API: "Create audiences using 
UserListService". Any reader of the release notes is naturally going to 
assume that all types of audiences can now be created with the API. Just 
changing this to "Create CRMBasedUserList and SimilarUserList audiences 
using UserListService. Support for other types of audiences will be added 
in future releases".would make things much clearer.

The only things in the API docs that I can find that you referenced state:

Union field user_list. The user list.

Exactly one must be set. user_list can be only one of the following:

 

crm_based_user_list
similar_user_list

 
Again, no mention is made of the other possible types of user lists, so the 
reader of the API docs is left to wonder whether other types of users lists 
are actually supported or not. The fact that it is possible to read (what I 
now understand are incomplete versions) these all types of users lists 
(including ExpressionBasedUserList, LogicalUserList, etc.) also leads API 
users to believe that the API has full support for all types of user lists. 
Just adding a statement like "Support for creating other types of user 
lists will be added in future versions of the API " to this part of your 
API docs would make things much clearer.

Once again, thanks for clarifying this for me,

Jon

On Friday, January 11, 2019 at 2:30:02 PM UTC-7, Dhanya Sundararaju 
(AdWords API Team) wrote:
>
> Hi Jon,
>
> Currently, only CRMBased User Lists and Similar user lists are supported 
> as stated in this section 
> 
>  of 
> the guide. Please keep an eye on the blog 
>  for 
> updates on future releases.
>
> Regards,
> Dhanya, Google Ads API Team
>

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/249b1d40-9258-423b-9107-137ad4163526%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Re: How do I create an audience using the new Google Ads API?

['Dhanya Sundararaju (AdWords API Team)' via AdWords API and Google Ads API Forum]

Hi Jon,

Currently, only CRMBased User Lists and Similar user lists are supported as 
stated in this section 

 of 
the guide. Please keep an eye on the blog 
 for 
updates on future releases.

Regards,
Dhanya, Google Ads API Team

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/ea4c9111-2064-41c9-9cde-d853217f016d%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

Re: How do I create an audience using the new Google Ads API?

['Dhanya Sundararaju (AdWords API Team)' via AdWords API and Google Ads API Forum]

Hi Jon,

Sorry for the delay as I was checking with my team on this. Instead, you 
will need to create an Info object (e.g., CrmBasedUserListInfo) and set it 
to the UserList object via the setCrmBasedUserList() method. 

  CrmBasedUserListInfo userList = CrmBasedUserListInfo.newBuilder()
  .setUploadKeyType(CustomerMatchUploadKeyType.CONTACT_INFO)
  .build();
  
  UserList newUserList = UserList.newBuilder()
  .setName(StringValue.of("Oler user list test 1"))
  .setCrmBasedUserList(userList)
  .build();

  UserListOperation userListOperation = UserListOperation.newBuilder()
  .setCreate(newUserList)
  .build();

That is, steps similar toAddExpandedTextAds 

 example.

Regards,
Dhanya, Google Ads API Team

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/678c3c9d-31c6-4ee3-8d65-2037ac457f71%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

How do I create an audience using the new Google Ads API?

[Jon Oler]

I am unable to create a new audience using the new Google Ads API. The 
release notes for version 0.6.0 of the API 
(https://developers.google.com/google-ads/api/docs/release-notes) claim 
that the ability to "Create audiences using UserListService" was added in 
this release. I am using version 0.6.0 of the java Google Ads SDK. Here is 
my code (it's groovy code using the java sdk, not Java code):

  // Look up an existing rule-based user list...
  UserList existingUserList = 
userListServiceClient.getUserList("customers/6257802538/userLists/4598470")

  // Use the rule-based user list I looked up to create a new user 
list. I need to clear some attributes to avoid API errors...
  UserList newUserList = UserList.newBuilder(existingUserList)
  .setName(StringValue.of("Oler user list test 1"))
  .clearId()
  .clearResourceName()
  .clearClosingReason()
  .build()

  UserListOperation userListOperation = UserListOperation.newBuilder()
  .setCreate(newUserList)
  .build()

  userListServiceClient.mutateUserLists('6257802538', 
[userListOperation])

Here is the API error I receive when I make this call:

errors {
  error_code {
user_list_error: CONCRETE_TYPE_REQUIRED
  }
  message: "Concrete type of user list is required."
  trigger {
string_value: ""
  }
  location {
operation_index {
}
  }
}

I get the same error when trying to create a LOGICAL user list instead of a 
RULE_BASED user list as I'm doing in the example. In my example code, I'm 
trying to copy an existing user list, but I've also tried creating the user 
list from scratch, and I received the exact same API error ("concrete type 
required"). I don't see where I can set things like the url on a rule-based 
user list or add references to other user lists when creating a logical 
user list. Is creating user lists really supported in 0.6.0 of the Google 
Ads API as the release notes indicate? If so, what am I doing wrong when 
I'm attempting to create these things?

-- 
-- 
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~

You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscr...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
--- 
You received this message because you are subscribed to the Google Groups 
"AdWords API and Google Ads API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to adwords-api+unsubscr...@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/adwords-api/76512321-bff4-4af9-b711-dbbf1cd97687%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.