使用 GoogleAdsService 製作報表
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如要擷取 Google Ads API 實體和報表資料,您可以使用下列其中一種方法:
以下是這兩種方法的概略差異:
SearchStream 與搜尋
雖然 Search
可傳送多個分頁要求以下載整份報表,但 SearchStream
會傳送單一要求,並啟動與 Google Ads API 的永久連線,無論報表大小為何。
如果是 SearchStream
,系統會立即開始下載資料封包,並在資料緩衝區中快取整個結果。您的程式碼不必等待整個串流完成,就能開始讀取緩衝的資料。
視應用程式而定,藉由消除要求 Search
回應個別頁面所需的往返網路時間,SearchStream
可以改善分頁效能,尤其是對大型報表而言。
範例
範例說明包含 100,000
列的報表。下表分析這兩種方法之間的會計差異。
|
SearchStream |
搜尋 |
頁面大小 |
不適用 |
每頁 10,000 列 |
API 要求數 |
1 項要求 |
10 個要求 |
API 回應數 |
1 個連續串流 |
10 則回應 |
在多數情況下,我們建議使用 SearchStream
而非 Search
,原因如下:
頻率限制
這兩種方法的每日限制均符合開發人員權杖的標準限制和存取層級。無論結果是否經過分頁或串流,單一查詢或報表都會計為一次作業。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-06-26 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-06-26 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","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-06-26 (世界標準時間)。"]]