Home Guides Reference Samples Support Policies Vendors

Method: userLists.list

Retrieves the Google Ads user lists associated with an Ads Data Hub customer. Additional users may be added to user lists with a call to userQueries.populateUserList.

HTTP request

GET https://fullcirclequery.googleapis.com/v2/userLists

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageSize

number

Maximum number of items to return. If 0, The server will determine the number of queries to return.

pageToken

string

Page token, returned by a previous call, used to request the next page of results, if any.

fullCircleCustomerId

string (int64 format)

The Ads Data Hub customer that owns the user list.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response to a userLists.list request. Contains the Ads Data Hub managed user lists to which the customer has access, sorted by userListId.

JSON representation 
{
  "userLists": [
    {
      object (UserList)
    }
  ],
  "nextPageToken": string
}
Fields
userLists[]

object (UserList)

A list of managed user lists.

nextPageToken

string

A token that can be used to request the next results page. This field is empty if there are no additional results.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/adsdatahub
  • https://www.googleapis.com/auth/xapi.zoo