必備條件

在開始設計第一個用戶端應用程式之前,您必須先做以下幾件事。

建立 Google 帳戶

您必須擁有 Google 帳戶,才能在 Google API 控制台中建立專案。如果您已經有帳戶,則您已準備好了。

您可能也想要另外使用一個測試用的 Google 帳戶。

試用 Google AdMob

這份 API 說明文件是假設您已經使用過 Google AdMob,也熟悉網頁程式設計概念和網頁資料格式。

如果您從未使用過 Google AdMob,不妨先試用使用者介面,再開始編寫程式碼。

為用戶端建立專案

向 Google AdMob 傳送請求前,您必須先向 Google 提供客戶的相關資訊,並啟用該 API 的存取權。如要這麼做,請使用 Google API 控制台建立「專案」,專案的名稱是一組具名的集合和 API 存取資訊,並註冊您的應用程式。

如要開始使用 AdMob API,請先使用設定工具,這項工具會逐步引導您在 Google API 控制台中建立專案、啟用 API,並建立憑證。

瞭解 REST 的基本概念

REST 是一種軟體架構,可提供簡便且一致的資料要求及修改方法。

REST 為 Representational State Transfer (具象狀態傳輸) 的簡稱。在 Google 的 API 中,這是指使用 HTTP 動詞來擷取及修改 Google 儲存的資料表示法。

在符合 REST 樣式的系統中,資源會儲存在資料儲存庫中。用戶端向伺服器發出執行特定動作 (例如建立、擷取、更新或刪除資源) 的要求後,伺服器就會執行指定動作並傳回回應 (大多採用指定資源表示法的形式)。

在 Google 的 REST 樣式 API 中,用戶端會使用 POSTGETPUTDELETE 等 HTTP 動詞指定動作。它會透過全域唯一的 URI 指定資源,格式如下:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

由於所有 API 資源都有可供 HTTP 存取的專屬 URI,因此 REST 不僅能夠支援資料快取,也非常適合與網路的分散式基礎架構搭配運作。

您可以在 HTTP 1.1 標準說明文件中找到實用的方法定義,其中包含 GETPOSTPUTDELETE 的規格。

AdMob API 中的 REST

AdMob API 作業與 REST HTTP 動詞直接對應。

AdMob API URI 專用格式如下:

https://admob.googleapis.com/v1/resourcePath?parameters

如需 API 中各項支援作業使用的完整 URI 組合摘要,請參閱 AdMob API 參考資料文件。

瞭解 JSON 的基本概念

AdMob API 會以 JSON 格式傳回資料。

JSON (JavaScript Object Notation) 是一種與語言無關的常用資料格式,可透過簡單的文字方式來呈現任意資料結構。詳情請參閱 json.org