This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
Starts execution on a transient user list query. The results uploaded to the specified Google Ads user list. The returned operation name can be used to poll for query completion status.
HTTP request
POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userListQueries:startTransient
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eExecutes a transient user list query and uploads results to a specified Google Ads user list.\u003c/p\u003e\n"],["\u003cp\u003eRequires providing the customer's resource name, the query to execute, execution parameters, and the target user list ID.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an operation name for tracking query completion status.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/adsdatahub\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eStartTransientUserListQuery\u003c/code\u003e is deprecated, use \u003ccode\u003eStartUserListQuery\u003c/code\u003e instead.\u003c/p\u003e\n"]]],["This document details the `startTransient` function, now deprecated in favor of `StartUserListQuery`, for executing queries on transient user lists. It uses a POST request to a specified customer path (`customers/*`) to start. The request body must include the `query` to be executed, `spec` for execution parameters, and `userListId` of the Google Ads user list. The function returns an `Operation` instance upon success and requires the `https://www.googleapis.com/auth/adsdatahub` authorization scope.\n"],null,["# Method: customers.userListQueries.startTransient\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\n| StartTransientUserListQuery is deprecated, use StartUserListQuery instead.\nStarts execution on a transient user list query. The results uploaded to the specified Google Ads user list. The returned operation name can be used to poll for query completion status.\n\n### HTTP request\n\n`POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userListQueries:startTransient`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------|\n| `parent` | `string` Full resource name of the customer executing the query, e.g. 'customers/123'. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"query\": { object (/ads-data-hub/reference/rest/v1/customers.userListQueries#UserListQuery) }, \"spec\": { object (/ads-data-hub/reference/rest/v1/QueryExecutionSpec) }, \"userListId\": string } ``` |\n\n| Fields ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `object (`[UserListQuery](/ads-data-hub/reference/rest/v1/customers.userListQueries#UserListQuery)`)` The query to execute. |\n| `spec` | `object (`[QueryExecutionSpec](/ads-data-hub/reference/rest/v1/QueryExecutionSpec)`)` Defines the query execution parameters. |\n| `userListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Google Ads user list ID. Note that the user list must be managed by the Ads Data Hub customer executing the query. |\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/ads-data-hub/reference/rest/v1/operations#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/adsdatahub`"]]