Method: queries.list
Stay organized with collections
Save and categorize content based on your preferences.
Lists queries created by the current user.
HTTP request
GET https://doubleclickbidmanager.googleapis.com/v2/queries
The URL uses gRPC Transcoding
syntax.
Query parameters
pageSize
integer
Maximum number of results per page. Must be between 1
and 100
. Defaults to 100
if unspecified.
pageToken
string
A token identifying which page of results the server should return. Typically, this is the value of nextPageToken
, returned from the previous call to the queries.list
method. If unspecified, the first page of results is returned.
orderBy
string
Field to sort the list by. Accepts the following values:
-
queryId
(default)
-
metadata.title
The default sorting order is ascending. To specify descending order for a field, add the suffix desc
to the field name. For example, queryId desc
.
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| Fields |
queries[]
|
object ( Query
)
The list of queries.
This field will be absent if empty.
|
nextPageToken
|
string
A token to retrieve the next page of results. Pass this value in the pageToken
field in the subsequent call to queries.list
method to retrieve the next page of results.
|
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/doubleclickbidmanager
For more information, see the OAuth 2.0 Overview
.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-28 UTC.
[[["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 2025-02-28 UTC."],[[["\u003cp\u003eLists queries created by the current user with support for pagination and sorting.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of maximum results per page (\u003ccode\u003epageSize\u003c/code\u003e) and retrieval of specific pages using tokens (\u003ccode\u003epageToken\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eEnables sorting by query ID or metadata title, with options for ascending or descending order (\u003ccode\u003eorderBy\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eProvides a JSON response containing an array of queries and a token for retrieving subsequent pages.\u003c/p\u003e\n"]]],[],null,["# Method: queries.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListQueriesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists queries created by the current user.\n\n### HTTP request\n\n`GET https://doubleclickbidmanager.googleapis.com/v2/queries`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Maximum number of results per page. Must be between `1` and `100`. Defaults to `100` if unspecified. |\n| `pageToken` | `string` A token identifying which page of results the server should return. Typically, this is the value of [nextPageToken](/bid-manager/reference/rest/v2/queries/list#body.ListQueriesResponse.FIELDS.next_page_token), returned from the previous call to the `queries.list` method. If unspecified, the first page of results is returned. |\n| `orderBy` | `string` Field to sort the list by. Accepts the following values: - `queryId` (default) - `metadata.title` The default sorting order is ascending. To specify descending order for a field, add the suffix `desc` to the field name. For example, `queryId desc`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------|\n| ``` { \"queries\": [ { object (/bid-manager/reference/rest/v2/queries#Query) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `queries[]` | `object (`[Query](/bid-manager/reference/rest/v2/queries#Query)`)` The list of queries. This field will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the [pageToken](/bid-manager/reference/rest/v2/queries/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `queries.list` method to retrieve the next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclickbidmanager`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
