# REST Resource: customers.userListQueries

- [Resource: UserListQuery](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries#UserListQuery)
  - [JSON representation](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries#UserListQuery.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries#METHODS_SUMMARY)

## 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 (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/ParameterType`) }, ... }, "queryState": enum (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/QueryState`), "updateTime": string, "updateEmail": string, "createTime": string, "createEmail": string, "queryShare": [ { object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/QueryShare`) } ], "userList": [ string ] } ``` |

| Fields ||
|---|---|
| `name` | `string` 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` | `string` Query title, which is unique within a single Ads Data Hub customer and query type. |
| `queryText` | `string` Query text. |
| `parameterTypes` | ``map (key: string, value: object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/ParameterType`))`` Any additional parameters expected by the query. Maps each argument name to its argument type. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `queryState` | ``enum (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/QueryState`)`` Query state. |
| `updateTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` 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: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `updateEmail` | `string` Output only. Email address of user who last updated the query. |
| `createTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` 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: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `createEmail` | `string` Output only. Immutable. Email address of user who created the query. |
| `queryShare[]` | ``object (`https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/QueryShare`)`` Indicates ways that a query may be shared beyond the owning Ads Data Hub customer. |
| `userList[]` | `string` Output only. The Ads Data Hub user list resource that can be populated by this user list query. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/create` | Creates a user list query for later execution. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/delete` | Deletes a user list query. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/get` | Retrieves the requested user list query. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/list` | Lists the user list queries owned by the specified customer. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/patch` | Updates an existing user list query. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/start` | Starts execution on a stored user list query. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/startTransient (deprecated)` | Starts execution on a transient user list query. |
| ### `https://developers.google.com/ads-data-hub/marketers/reference/rest/v1/customers.userListQueries/validate` | Performs static validation checks on the provided user list query. |