最新版的 AdSense Management API 是 v2。所有的先前版本 (v1.x) 將無法再使用。
如要升級至第 2 版,請務必先查看版本資訊。由於這是重大版本變更,因此會出現破壞性變更。準備好進行必要的變更時,請根據您存取 API 的方式,選取下方其中一個入門選項。
如果您使用動態程式設計語言
如果您將用戶端程式庫用於我們支援的其中一種動態程式設計語言 (例如 Ruby 或 Python),就應該更新程式碼中的版本字串。
以 Python 為例:
http = httplib2.Http() service = build("adsense", "v2", http=http)
或 Ruby:
client = Google::APIClient.new adsense = client.discovered_api('adsense', 'v2')
如果您使用靜態程式設計語言
如果您將用戶端程式庫用於我們支援的其中一種靜態程式設計語言 (例如 Java、PHP 或 C#/.NET),就必須更新 AdSense Management API 專用模組。
注意:由於核心用戶端程式庫會隨著時間進行數次變更,因此更新這些模組時可能也需要更新核心用戶端程式庫,也就是說,您的程式碼可能會進一步變更。如果您遇到這種情況,請參閱用戶端程式庫的說明文件。
Java
請確定您使用的是最新版 AdSense Management API 程式庫,並更換專案依附元件。
PHP
請務必更新至最新版完整 PHP 用戶端程式庫。這應該包括最新版 AdSense Management API 模組和所有其他 API。
C#/.NET
請確定您使用的是最新版 AdSense Management API 程式庫,並更換專案依附元件。
如果您並未使用用戶端程式庫
如果您未使用其中一個用戶端程式庫,就必須更新要求中使用的基本網址。例如:
https://www.googleapis.com/adsense/v1.4/
會變成:
https://adsense.googleapis.com/v2/
在某些情況下 (尤其是針對報表要求),您也必須調整要使用新路徑和查詢參數的網址,以及在許多情況下處理稍有不同的回應物件;這些詳細資料都已記錄在 API 參考資料中。