必備條件

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

申請 Google 帳戶

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

您可能也想另外建立測試用的 Google 帳戶。

試用 Google AdMob

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

如果您還沒有使用過 Google AdMob,在開始編寫程式碼之前,請先試用使用者介面

為用戶端建立專案

您必須先將用戶端相關資訊告知 Google,並啟用 API 存取權,才能傳送請求給 Google AdMob。如要註冊這項計畫,請使用 Google API 控制台建立「專案」(專案為具名的集合,內含設定和 API 存取資訊),並註冊應用程式。

如要開始使用 AdMob API, 使用 設定工具,會引導您在 Google API 控制台,啟用 API 並建立憑證。

瞭解 REST 的基本概念

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

REST 這個詞是「Representational State Transfer (表現層狀態轉換)」的簡稱。在 Google API 中,這是指使用 HTTP 動詞來擷取及修改 Google 所儲存資料的表示法。

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

在具備 REST 特性的各種 Google 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