發布新版本後,系統會為已淘汰版本設定服務終止日期,屆時該版本將無法再使用。請注意以下其他準則:
- 我們盡量維持最多三個主要版本。
- 主要版本的效期約為 12 個月,次要版本則為 10 個月。
- 您每年最多只能升級兩次,而且不必依序升級,例如可以直接從第 N 版升級至第 N+2 版。
- 最新版本的所有用戶端程式庫發布日期,與即將淘汰的版本之間,至少有 20 週的重疊期。
我們的用戶端程式庫支援任何可用的服務版本,因此您可以指定所用服務的不同版本,逐步升級。
時刻表
下表列出各個可用版本的確切淘汰和停止支援日期,以及未來版本的預計發布日期。建議您在最新版本發布後,盡快升級至最新版本。
API 版本 | 發布日期 | 淘汰日期 | 服務終止日期 | 升級指南 |
---|---|---|---|---|
v20 | 2025 年 6 月 4 日 | 從第 19 版升級至第 20 版 | ||
v19.1 | 2025 年 4 月 16 日 | |||
v19 | 2025 年 2 月 26 日 | 從第 18 版升級至第 19 版 | ||
v18 | 2024 年 10 月 16 日 | 2025 年 6 月 | 2025 年 8 月 | 從第 17 版升級至第 18 版 |
查看專案使用的版本
您可以使用 Google Cloud 控制台,查看專案最近呼叫的方法和服務清單:
- 在 Google Cloud 控制台中開啟「APIs & Services」(API 和服務)。
- 按一下表格中的「Google Ads API」。
- 在「指標」子分頁中,您應該會看到每個圖表上繪製的近期要求。您可以在「方法」表格中,查看已傳送要求的方法。方法名稱包含 Google Ads API 版本、服務和方法名稱,例如
google.ads.googleads.v20.services.GoogleAdsService.Mutate
。 - (選用) 選擇要查看要求的時間範圍。
淘汰和終止的差異
字詞 | 淘汰 | 日落 |
---|---|---|
定義 | 已淘汰版本是指不是最新版本的版本。 新版本發布後,所有舊版本都會標示為已淘汰。 | 您無法再使用停止服務的版本。在服務終止日期當天或之後,傳送至這個版本的任何要求都會失敗。 |
影響 | 您仍可使用已淘汰的版本,直到淘汰為止,
但系統會取消醒目顯示已淘汰版本的參照,表示這些版本已不是最新版本。
建議您盡快升級至最新版本,以便使用新功能。 |
如要使用 Google Ads API,請立即從已淘汰的版本升級。
我們強烈建議您使用升級指南,升級至最新版本。 |
時間 | 我們平均每 3 到 4 個月會發布新版本,因此指定版本會在約 3 到 4 個月後淘汰。 | 我們預計會在版本發布 1 年後停止支援。 |
API | 淘汰版本的 API 端點仍會照常運作。
您可以使用用戶端程式庫、REST 等方式存取 API 端點,但系統不會在已淘汰的版本中新增功能。 |
服務終止日期過後,停止服務版本的 API 端點將停止運作。如果您嘗試存取已淘汰版本的 API 端點,Google Ads API 會擲回錯誤。 |
用戶端程式庫 | 為提供精簡的用戶端程式庫,我們將在淘汰日期過後,停止在新版用戶端程式庫中納入已淘汰的 API 版本。在專案中併入用戶端程式庫時,這有助於節省空間。 | 在服務終止日期過後,任何新版用戶端程式庫都不再支援停止服務的 API 版本。 |
支援 | 我們會定期為已淘汰版本提供支援。 | 服務終止日期過後,我們就不再支援停止服務的版本。 |
支援的用戶端程式庫版本
下表列出各個 API 版本適用的用戶端程式庫。
Java
Google Ads API |
適用於 Java 的用戶端程式庫 |
v20 |
Min: 38.0.0 Max: - |
v19 |
Min: 36.0.0 Max: - |
v18 |
Min: 34.0.0 Max: - |
v17 |
Min: 31.0.0 Max: 36.1.0 |
C#
Google Ads API |
.NET 專用的用戶端程式庫 |
v20 |
Min: 23.0.0 Max: - |
v19 |
Min: 22.1.0 Max: - |
v18 |
Min: 21.1.0 Max: - |
v17 |
Min: 20.1.0 Max: 22.2.0 |
PHP
Google Ads API |
PHP 用戶端程式庫 |
v20 |
Min: 28.0.0 Max: - |
v19 |
Min: 26.1.0 Max: - |
v18 |
Min: 25.0.0 Max: - |
v17 |
Min: 23.1.0 Max: 27.2.0
|
Python
Google Ads API |
Python 專用的用戶端程式庫 |
v20 |
Min: 27.0.0 Max: - |
v19 |
Min: 25.2.0 Max: - |
v18 |
Min: 25.1.0 Max: - |
v17 |
Min: 24.1.0 Max: 26.1.0 |
小茹
Google Ads API |
Ruby 適用的用戶端程式庫 |
v20 |
Min: 34.0.0 Max: - |
v19 |
Min: 32.0.0 Max: - |
v18 |
Min: 31.0.0 Max: - |
Perl
Google Ads API |
Perl 適用的用戶端程式庫 |
v20 |
Min: 27.0.0 Max: - |
v19 |
Min: 26.0.0 Max: - |
v18 |
Min: 25.0.1 Max: - |
淘汰功能
請定期查看 Google Ads 開發人員網誌,搶先掌握即將淘汰的功能。
下表列出 Google Ads API 預計淘汰的特定功能。如要進一步瞭解各項淘汰作業,請參閱連結的網誌文章。
功能 | 說明 | 生效日期 | 其他注意事項 |
---|---|---|---|
無效開發人員權杖的新錯誤訊息 | 自 2025 年 4 月 28 日起,無效的開發人員權杖會傳回:
DEVELOPER_TOKEN_INVALID (適用於 19.1 以上版本) 和
DEVELOPER_TOKEN_NOT_APPROVED (適用於 19.1 之前的版本)。先前傳回的開發人員權杖無效 OAUTH_TOKEN_HEADER_INVALID ,但仍會用於無效的 OAuth 標頭。 |
2025 年 4 月 28 日 | 這項異動不會影響已正常運作的 API 呼叫。 |