查詢每日的資料量，即可快速查詢效能資料，而且不會超過配額。
您必須選擇要納入資料中的資訊：哪些搜尋類型 (網頁、圖片、影片等) 以及指定維度 (網頁、查詢、國家/地區或裝置)，以及是否要依網頁或資源將結果分組。查詢網頁和/或查詢字串時，某些資料可能會遭到捨棄 (瞭解原因)。
總覽
- 建議您使用下方所述的查詢樣式，每天執行查詢，涵蓋一天的資料。每日查詢一天的資料不應超過每日配額。系統通常需 2 到 3 天後才能取得資料；您可以查看過去 10 天內依日期分組的簡單查詢，瞭解最新資料。編寫查詢時：
- 選擇是否要依網頁或資源分類結果。
- 選擇要在查詢中納入更完整的計數或維度。注意：您必須使用兩步驟程序查詢搜尋外觀資料 (AMP、藍色連結、複合式搜尋結果等)。
- 重新執行相同查詢，將要求中的
startRow值調高 25,000，直到抵達最後一頁 (傳回 0 列的回應)，以頁面瀏覽結果。 - 您可以選擇使用其他
type參數執行相同查詢。
以下是單一查詢的虛擬程式碼範例。針對您想要的資料，您可以每天
為每個 type 值執行一次此測試。
int maxRows = 25000; // Current max response size
int i = 0;
do {
response = Request(startDate = 3_days_ago,
endDate = 3_days_ago,
... add dimensions, type ...
rowLimit = maxRows,
startRow = i * maxRows);
i++;
… // Do something with the response data.
} while (response.rows.count() != 0); // Page through all result rows
數據用量上限
除了 API 用量配額之外，Search Analytics 方法每天最多能為每種搜尋類型 (網頁、圖片等) 顯示 5 萬列資料 (按點擊次數排序)。
查詢詳細資料
已依網頁分組
如要獲得準確的計數，您必須略過網頁和查詢維度，如下所示：
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate/endDate：選取同一日期，即可選用一天的回溯期。dimensions：視需要加入country和/或device。type：在獨立查詢中視需要以 每個type值進行列舉。aggregationType：必須為byPage。
如需網頁和/或查詢資訊等詳細資訊，請執行以下查詢，但您可能會遺失部分資料：
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate/endDate：選取同一日期，即可選用一天的回溯期。dimensions：包含page。視需要納入query、country或device的任意組合。type：在獨立查詢中視需要以 每個type值進行列舉。
已依資源分組
如要獲得準確的計數，您必須略過網頁和查詢維度，如下所示：
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate/endDate：選取同一日期，即可選用一天的回溯期。dimensions：視需要加入country和/或device。type：視需要在獨立查詢中，逐一列舉 每個type值。
如需查詢、國家/地區和/或裝置資訊等更詳細的資訊，系統可能會遺失部分資料，但您必須執行下列查詢：
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate/endDate：選取同一日期，即可選用一天的回溯期。dimensions：視需要納入query、country或device的任意組合。type：在獨立查詢中視需要以 每個type值進行列舉。
依網頁或資源將結果分組
依網頁 (而非資源) 分組結果時，曝光次數、點擊次數、排名和點閱率的計算方式會有所不同。瞭解詳情。
為什麼在要求詳細資訊時遺失資料？
依網頁和/或查詢分組時，系統可能會捨棄部分資料，以便在合理的運算資源內計算出結果。
取得搜尋外觀資料
搜尋外觀無法與其他維度一併提供。因此，如要查看網站的搜尋外觀資訊，請按照下列程序操作：
- 指定「
searchAppearance」做為唯一的維度，這會依搜尋外觀類型將所有資料分組，而且沒有其他維度。 - 視需要執行第二次查詢，依照步驟 1 列出的其中一個搜尋外觀類型進行篩選，在查詢中加入任何所需維度 (網頁、國家/地區、查詢等)。
如要擷取多種搜尋外觀類型的資料，您必須針對步驟 1 列出的每個搜尋外觀類型執行第二個步驟。
第一個查詢：
取得網站上搜尋外觀類型的清單。
{
"startDate": "2018-05-01",
"endDate": "2018-05-31",
"type": "web",
"dimensions": [
"searchAppearance"
]
}
結果：
您的網站類型為 INSTANT_APP、AMP_BLUE_LINK 等。
"rows": [
{
"keys": [
"INSTANT_APP"
],
"clicks": 443024.0,
"impressions": 4109826.0,
"ctr": 0.10779629113251997,
"position": 1.088168452873674
},
{
"keys": [
"AMP_BLUE_LINK"
],
"clicks": 429887.0,
"impressions": 1.7090884E7,
"ctr": 0.025152999692701676,
"position": 7.313451603790653
},...
第二項查詢：
您可以按照步驟 1 提供的其中一種搜尋外觀類型進行篩選，並視需要篩選任何維度 (網頁、裝置等)。我們是根據 AMP_BLUE_LINK 進行篩選。
{
"startDate": "2018-05-01",
"endDate": "2018-05-31",
"type": "web",
"dimensions": [
"device" // and/or page, country, ...
],
"dimensionFilterGroups": [
{
"filters": [
{
"dimension": "searchAppearance",
"operator": "equals",
"expression": "AMP_BLUE_LINK"
}
]
}
]
}
結果：
AMP_BLUE_LINK 細目，依裝置類型顯示。
"rows": [
{
"keys": [
"MOBILE"
],
"clicks": 429887.0,
"impressions": 1.7090783E7,
"ctr": 0.025153148337323107,
"position": 7.31339517914422
},
{
"keys": [
"DESKTOP"
],
"clicks": 0.0,
"impressions": 66.0,
"ctr": 0.0,
"position": 12.257575757575758
},
...