Page Summary
-
A UserListQuery resource defines a query that can be executed within Ads Data Hub to populate user lists.
-
The resource includes fields such as name, title, queryText, and information about creation and updates.
-
Available methods for UserListQuery include creating, deleting, getting, listing, patching, starting, and validating queries.
Resource: UserListQuery
Defines a user list query that can be executed within Ads Data Hub.
| JSON representation |
|---|
{ "name" : string , "title" : string , "queryText" : string , "parameterTypes" : { string : { object ( |
| Fields | |
|---|---|
name
|
Output only. Immutable. Name that uniquely identifies a query. It has the form customers/[customerId]/userListQueries/[resource_id], e.g. 'customers/123/userListQueries/abcd1234'. The resource ID is generated by the server. |
title
|
Query title, which is unique within a single Ads Data Hub customer and query type. |
queryText
|
Query text. |
parameterTypes
|
Any additional parameters expected by the query. Maps each argument name to its argument type. An object containing a list of |
queryState
|
Query state. |
updateTime
|
Output only. Time the query was last updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateEmail
|
Output only. Email address of user who last updated the query. |
createTime
|
Output only. Immutable. Time the query was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
createEmail
|
Output only. Immutable. Email address of user who created the query. |
queryShare[]
|
Indicates ways that a query may be shared beyond the owning Ads Data Hub customer. |
userList[]
|
Output only. The Ads Data Hub user list resource that can be populated by this user list query. |
Methods |
|
|---|---|
|
Creates a user list query for later execution. |
|
Deletes a user list query. |
|
Retrieves the requested user list query. |
|
Lists the user list queries owned by the specified customer. |
|
Updates an existing user list query. |
|
Starts execution on a stored user list query. |
(deprecated) |
Starts execution on a transient user list query. |
|
Performs static validation checks on the provided user list query. |


