Home Guides Reference Samples Support Policies Vendors

REST Resource: userLists

Resource: UserList

Information about a UserList.

JSON representation 
{
  "userListId": string,
  "name": string,
  "description": string,

  // Union field list_owner can be only one of the following:
  "adwordsCustomerId": string,
  "adsDataCustomerId": string
  // End of list of possible types for union field list_owner.
}
Fields
userListId

string (int64 format)

The id of the user list.

name

string

Name of the user list.

description

string

Description of the user list.

Union field list_owner. The customer that owns the list. Either a GoogleAds customer or an Ads Data Hub data customer. list_owner can be only one of the following:
adwordsCustomerId
(deprecated)

string (int64 format)

Id of the Google Ads customer that owns the user list.
adsDataCustomerId

string (int64 format)

Linked Ads Data Hub customer ID associated with this user list. This ID must be specified as the adsDataCustomerId when executing queries using this user list.

Methods

create

 Creates a user list in Google Ads to be populated from ADH queries.

get

 Retrieves a Google Ads user list for the given user list id.

list

 Retrieves the Google Ads user lists associated with an Ads Data Hub customer.