Page Summary
-
A UserListQuery defines a query that can be executed within Ads Data Hub to populate a user list.
-
The UserListQuery resource includes fields such as name, title, queryText, parameterTypes, and queryState.
-
Several methods are available for managing UserListQueries, including create, delete, get, list, patch, start, and validate.
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. |


