這份變更記錄會列出「API 設計指南」的重大異動，例如命名慣例、錯誤處理和標準欄位的修訂內容。此外，這項工具也會將說明文件遷移至 Google API 改進提案 (AIP)，並記錄相關作業。
2025-06
- 將「設計」頁面的命名慣例重新導向至 Google AIP。
2024-10
- 將「設計」頁面重新導向至 Google AIP，但「目錄結構」和「命名慣例」除外。
2021-12
- 將「Networked API」改為「Network API」，與 https://google.aip.dev/9 保持一致。
2021-09
- 記錄 Google API 錯誤格式第 1 版和第 2 版。
2021-04
推出以可見度為準的版本控管功能。
在詞彙表中加入 API 標題。
2021-03
為僅限輸出的欄位新增註解。
更新列舉值指南，一律加入明確的
_UNSPECIFIED值。新增如何產生及剖析資源名稱的指引。
在標準欄位中新增
progress_percent。
2021-02
- 新增有關 proto3
optional原始欄位的指引。
2021-01
更新「錯誤」頁面，涵蓋與
google.rpc.ErrorInfo和google.api.ErrorReason相關的最新改善項目。新增使用
oauth2l、curl和系統參數排解 Google API 錯誤的指南。在「錯誤」頁面中新增
502錯誤代碼說明。這是網路錯誤，而非 API 錯誤。
2020-12
- 為確保全域一致性，套件名稱應使用單數元件名稱。套件名稱不得使用底線。
2020-09
簡化部分欄位說明規定；將 RFC 2119 以外的「必須」改為 RFC 2119「應」指令。
移除
bool deleted標準欄位，改用google.protobuf.Timestamp delete_time(已列出)。
2020-07
更新 documentation.md，使其符合 https://google.aip.dev/192#formatting。請勿在 proto 註解中使用 Markdown 表格和原始 HTML。
新增
ErrorInfo，用於錯誤處理。新增設計模式的大型酬載。
2020-04
- 在詞彙表中，將 Cloud API 重新命名為 Google Cloud API。
- 將 API 和服務視為 API 服務的同義詞。
2020-02
- 更新版本管理，新增兩種版本管理策略 (以頻道為準和以發布為準)，移除有關點版本的指引，並變更我們指稱語意化版本管理的方式。
2020-01
- 在設計模式中新增資料保留期限。
2019-11
- 將術語 Cloud API 新增至詞彙表。
- 建議用戶端只針對 UNAVAILABLE 錯誤重試。
2019-06
- 在設計模式中新增「Bool vs Enum vs String」。
2019-03
- 在標準欄位中新增系統參數。
2019-02
- 在設計模式中新增網域範圍名稱。
2018-03
- 在設計模式中新增串流半關閉語意。
2018-02
- 將
read_time新增至標準欄位。
2018-01
- 新增 API 服務定義的結構定義參考資料。
2017-12
- 說明 API 主要版本必須為 proto 套件名稱的最後一個組成部分。
2017-11
- 說明
Create方法為何會採用輸入資源。 - 說明沒有複數形式的集合 ID，例如 evidence (證據) 和 weather (天氣)。
- 將單例資源新增至設計模式。
- 說明縮寫字和版本的 C# 命名慣例。
2017-09
- 在標準欄位中新增
mime_type。 - 在標準欄位中新增
expire_time。 - 將
start_time和end_time新增至標準欄位。
2017-02
- 在詞彙中新增「API 端點」。
- 在標準欄位中新增
update_mask。 - 將
FieldMask連結新增至標準方法。 - 提及 OpenAPI 規格不支援無正負號整數。
- 說明方法名稱的動詞應使用祈使語氣。