Queries: runquery
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
執行已儲存的查詢來產生報表。
立即試用。
要求
HTTP 要求
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId
參數
參數名稱 |
值 |
說明 |
路徑參數 |
queryId |
long |
要執行的查詢 ID。
|
選用的查詢參數 |
asynchronous |
boolean |
查詢是否應以非同步方式執行。如果為 true,這個方法
會立即傳回。如果指定 false 或未指定值,這個方法就不會
系統會傳回 值。
(預設值:false )
|
授權
此要求需要具有下列範圍的授權:
範圍 |
https://www.googleapis.com/auth/doubleclickbidmanager |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中,提供具有以下結構的資料:
{
"dataRange": string,
"reportDataStartTimeMs": long,
"reportDataEndTimeMs": long,
"timezoneCode": string
}
屬性名稱 |
值 |
說明 |
附註 |
dataRange |
string |
用來產生報表的報表資料範圍。
可接受的值為:
- 「
ALL_TIME 」
- 「
CURRENT_DAY 」
- 「
CUSTOM_DATES 」
- 「
LAST_14_DAYS 」
- 「
LAST_30_DAYS 」
- 「
LAST_365_DAYS 」
- 「
LAST_60_DAYS 」
- 「
LAST_7_DAYS 」
- 「
LAST_90_DAYS 」
- 「
MONTH_TO_DATE 」
- 「
PREVIOUS_DAY 」
- 「
PREVIOUS_HALF_MONTH 」
- 「
PREVIOUS_MONTH 」
- 「
PREVIOUS_QUARTER 」
- 「
PREVIOUS_WEEK 」
- 「
PREVIOUS_YEAR 」
- 「
QUARTER_TO_DATE 」
- 「
TYPE_NOT_SUPPORTED 」
- 「
WEEK_TO_DATE 」
- 「
YEAR_TO_DATE 」
|
|
reportDataStartTimeMs |
long |
報表所顯示資料的開始時間。請注意,如果 dataRange 是 CUSTOM_DATES ,就必須提供 reportDataStartTimeMs ,否則就忽略。 |
|
reportDataEndTimeMs |
long |
報表所顯示資料的結束時間。請注意,如果 dataRange 是 CUSTOM_DATES ,就必須提供 reportDataEndTimeMs ,否則就忽略。 |
|
timezoneCode |
string |
報表資料時間的標準時區代碼。預設值為 America/New_York 。 |
|
試試看!
使用下方的 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 should migrate to Bid Manager API v2.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this version may return errors, and specific fields in retrieved \u003ccode\u003eQuery\u003c/code\u003e resources will be empty.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erunquery\u003c/code\u003e request runs a stored query to generate a report, accepting parameters like \u003ccode\u003equeryId\u003c/code\u003e, \u003ccode\u003easynchronous\u003c/code\u003e, \u003ccode\u003edataRange\u003c/code\u003e, and time parameters.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope is required for this request.\u003c/p\u003e\n"]]],["The Bid Manager API v1.1 is sunset; users must migrate to v2. Requests to v1.1 may error, and successful requests will return empty `metadata.googleCloudStoragePathForLatestReport`, `metadata.latestReportRunTimeMs`, and `metadata.googleDrivePathForLatestReport` fields. To run a query, send a POST request with the `queryId`, optional asynchronous parameter, and report data range, start/end times, and timezone in the request body. This requires authorization with the `doubleclickbidmanager` scope.\n"],null,["# Queries: runquery\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\nRuns a stored query to generate a report.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `queryId` | `long` | Query ID to run. |\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. (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 data with the following structure:\n\n```text\n{\n \"dataRange\": string,\n \"reportDataStartTimeMs\": long,\n \"reportDataEndTimeMs\": long,\n \"timezoneCode\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `dataRange` | `string` | Report data range used to generate the report. \u003cbr /\u003e Acceptable values are: - \"`ALL_TIME`\" - \"`CURRENT_DAY`\" - \"`CUSTOM_DATES`\" - \"`LAST_14_DAYS`\" - \"`LAST_30_DAYS`\" - \"`LAST_365_DAYS`\" - \"`LAST_60_DAYS`\" - \"`LAST_7_DAYS`\" - \"`LAST_90_DAYS`\" - \"`MONTH_TO_DATE`\" - \"`PREVIOUS_DAY`\" - \"`PREVIOUS_HALF_MONTH`\" - \"`PREVIOUS_MONTH`\" - \"`PREVIOUS_QUARTER`\" - \"`PREVIOUS_WEEK`\" - \"`PREVIOUS_YEAR`\" - \"`QUARTER_TO_DATE`\" - \"`TYPE_NOT_SUPPORTED`\" - \"`WEEK_TO_DATE`\" - \"`YEAR_TO_DATE`\" | |\n| `reportDataStartTimeMs` | `long` | The starting time for the data that is shown in the report. Note, `reportDataStartTimeMs` is required if `dataRange` is `CUSTOM_DATES` and ignored otherwise. | |\n| `reportDataEndTimeMs` | `long` | The ending time for the data that is shown in the report. Note, `reportDataEndTimeMs` is required if `dataRange` is `CUSTOM_DATES` and ignored otherwise. | |\n| `timezoneCode` | `string` | Canonical timezone code for report data time. Defaults to `America/New_York`. | |\n\nResponse\n--------\n\nIf successful, this method returns an empty 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.runquery)."]]