在開始設計第一個用戶端應用程式之前,您必須先做以下幾件事。
建立 Google 帳戶
您必須擁有 Google 帳戶,才能在 Google API 控制台中建立專案。如果您已經有帳戶,則您已準備好了。
您可能也想要另外有個測試用的 Google 帳戶。
試用 Google 廣告體驗報表
此 API 說明文件假設您使用 Google 廣告體驗報告,且熟悉網路程式設計概念和網路資料格式。
如果您還沒使用 Google 廣告體驗報表,請在開始編寫程式碼前試用使用者介面。
為用戶端建立專案
您必須先向 Google 告知客戶並啟用 API 存取權,才能向 Google 廣告體驗報告傳送請求。只要使用 Google API 控制台來建立「專案」 (內含已命名的設定和 API 存取權資訊),並註冊應用程式即可。
瞭解 REST 的基本概念
您可以透過下列 2 種方式叫用 API:
- 傳送 HTTP 要求並剖析回應。
- 使用用戶端程式庫。
如果您決定不使用用戶端程式庫,則必須瞭解 REST 的基本概念。
REST 是一種軟體架構,可提供簡便且一致的資料要求及修改方法。
REST 為 Representational State Transfer (具象狀態傳輸) 的簡稱。在 Google 的 API 中,這是指使用 HTTP 動詞來擷取及修改 Google 儲存的資料表示法。
在符合 REST 樣式的系統中,資源會儲存在資料儲存庫中。用戶端向伺服器發出執行特定動作 (例如建立、擷取、更新或刪除資源) 的要求後,伺服器就會執行指定動作並傳回回應 (大多採用指定資源表示法的形式)。
在 Google 的 RESTful API 中,用戶端會使用 HTTP 動詞指定動作,例如 POST
、GET
、PUT
或 DELETE
。並由下列格式的全域不重複 URI 指定資源:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
由於所有 API 資源都有可供 HTTP 存取的專屬 URI,因此 REST 不僅能夠支援資料快取,也非常適合與網路的分散式基礎架構搭配運作。
HTTP 1.1 標準說明文件中的方法定義可能非常實用,其中包含 GET
、POST
、PUT
和 DELETE
的規格。
Google Ad Experience Report API 中的 REST
Google Ad Experience Report API 作業直接對應至 REST HTTP 動詞。
Google Ad Experience Report API URI 專用格式如下:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
請參閱 Google Ad Experience Report API 參考資料文件,概略瞭解 API 中每個支援的作業使用的 URI 組合。
瞭解 JSON 的基本概念
Google Ad Experience Report API 會傳回 JSON 格式的資料。
JSON (JavaScript 物件標記法) 是一種常見的語言獨立資料格式,可透過簡單的文字顯示任意資料結構。詳情請參閱 json.org。