2026 年 5 月 1 日，星期五
自 2026 年 6 月 1 日起，Google Ads 和相關 Measurement API 將改採 37 個月的資料保留政策，保留精細的成效統計資料 (每日、每小時和每週)。概要資料 (每月、每季和每年) 則會保留 11 年。
| API | 影響 | 後續步驟 |
| Google Ads API 和 Google Ads 指令碼 | 自 2026 年 6 月 1 日起，如果查詢要求取得目前日期 37 個月前的精細區隔 (例如：segments.date、segments.week)，系統會傳回 DateRangeError.INVALID_DATE 錯誤。未來的 API 版本會傳回 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED 錯誤。如要擷取 37 個月前的資料，則必須更新查詢，以改用 segments.month、segments.quarter 或 segments.year。若要查詢歷來資料，未區隔的查詢範圍必須與日曆月份的界線 (當月 1 日至最後一天) 完全相符。
|
請檢查並更新應用程式。如果需要 37 個月前的精細歷來資料，建議您在 2026 年 6 月 1 日期限前匯出。
如有任何疑問，歡迎透過 Google Ads API 支援管道或 Google Ads 指令碼支援管道與我們聯絡。 |
| Google Analytics Data API | 如果報表也使用「日期」維度，Google Analytics Data API 會將受影響的指標截斷至最近 36 個月的時間範圍。受影響的指標包括廣告主廣告費用、點擊次數和曝光次數。只有包含所有受影響指標、37 個月以上，且包含「日期」維度的報表會受到影響。「星期幾」和「日期」等日期等效維度也會受到影響。 | 請檢查資料拼接邏輯，將這項截斷機制納入考量。 |
| DV360 API 和 CM360 API | 這些 API 目前的保留期限為 24 個月，這項規定維持不變。 | 不會。 |
| BigQuery 資料移轉服務 | 2026 年 6 月 1 日起，Google Ads 適用的 BigQuery 資料移轉服務和 Search Ads 360 適用的 BigQuery 資料移轉服務連接器，將停止為回填作業填入資料，日期早於目前日期 37 個月以上的資料將不再填入。轉移並儲存在 BigQuery 的資料會保留在資料表中，不受影響。
2026 年 6 月 1 日起，Google Analytics 4 連接器的 BigQuery 資料移轉服務，將停止為回填執行作業填入資料，日期早於目前日期 37 個月以上的資料將無法回填。轉移並儲存在 BigQuery 的資料會保留在資料表中，但如果手動觸發轉移的報表日期為 37 個月前或更早，BigQuery 資料表中該日期的資料會遭到空白值覆寫。 |
如要在 BigQuery 保留 37 個月前的歷來資料，建議您提早開始執行補充作業，以便在 2026 年 6 月 1 日前完成。 |
如有任何疑問，或想討論這篇文章，歡迎透過 Google 廣告與評估社群 Discord 頻道與我們聯絡。
Nadine Wang，廣告和 Measurement API 團隊
標籤： google-ads-api、 google-ads-scripts、 google-analytics-api