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 和/或其關聯企業的註冊商標。
上次更新時間:2024-08-22 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-08-22 (世界標準時間)。"],[[["This version of the Bid Manager API is sunset, and users should migrate to Bid Manager API v2."],["Requests to this version may return errors, and specific fields in retrieved `Query` resources will be empty."],["The `runquery` request runs a stored query to generate a report, accepting parameters like `queryId`, `asynchronous`, `dataRange`, and time parameters."],["Authorization with the `https://www.googleapis.com/auth/doubleclickbidmanager` scope is required for this request."]]],["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"]]