Queries: createquery
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
建立查詢。如果排程頻率為 ONE_TIME，系統也會自動執行已建立的查詢。
立即試用。
要求
HTTP 要求
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query
參數
| 參數名稱 |
值 |
說明 |
| 選用的查詢參數 |
asynchronous |
boolean |
查詢是否應以非同步方式執行。如果為 true，這個方法
會立即傳回。如果指定 false 或未指定值，這個方法就不會
系統會傳回 值。僅適用於
頻率為 ONE_TIME。
(預設值：false)
|
授權
此要求需要具有下列範圍的授權：
| 範圍 |
|---|
https://www.googleapis.com/auth/doubleclickbidmanager |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中，提供查詢資源。
回應
如果成功，這個方法會在回應主體中傳回查詢資源。
試試看！
使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。
您也可以改用
獨立式
Explorer。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThis version of the Bid Manager API is sunset, and users must migrate to Bid Manager API v2.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this version may return an error, and certain fields in retrieved \u003ccode\u003eQuery\u003c/code\u003e resources will be empty.\u003c/p\u003e\n"],["\u003cp\u003eCreating a query with a \u003ccode\u003eONE_TIME\u003c/code\u003e schedule frequency automatically runs the query.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope is required.\u003c/p\u003e\n"]]],[],null,["# Queries: createquery\n\n| This version of the Bid Manager API has been sunset. Users must [migrate to Bid Manager API v2](/bid-manager/how-tos/v2-migration).\n|\n|\n| Requests to this version may return an error. If the request is successful, the following fields in retrieved [`Query`](/bid-manager/v1.1/queries#resource) resources will be empty:\n|\n| - [`metadata.googleCloudStoragePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleCloudStoragePathForLatestReport)\n| - [`metadata.latestReportRunTimeMs`](/bid-manager/v1.1/queries#metadata.latestReportRunTimeMs)\n| - [`metadata.googleDrivePathForLatestReport`](/bid-manager/v1.1/queries#metadata.googleDrivePathForLatestReport)\n|\n| \u003cbr /\u003e\n|\n| **Note:** Requires [authorization](#auth).\n\nCreates a query. When the schedule frequency is `ONE_TIME`, the created query is also run automatically.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/query\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Optional query parameters** |||\n| `asynchronous` | `boolean` | Whether the query should be run asynchronously. When true, this method will return immediately. When false or not specified, this method will not return until the query has finished running. Only applicable when the frequency is `ONE_TIME`. (Default: `false`) |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` |\n\nFor more information, see the [authentication and authorization](/bid-manager/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Queries resource](/bid-manager/v1.1/queries#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [Queries resource](/bid-manager/v1.1/queries#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclickbidmanager/v1.1/doubleclickbidmanager.queries.createquery)."]]
