開始使用 AdMob API

重要事項： 新的使用者角色和權限會影響 AdMob API 傳回的資料。瞭解詳情

本指南旨在協助開發人員利用 AdMob API，以程式輔助方式取得 AdMob 帳戶相關資訊。

所有 Google AdMob API 呼叫都必須透過 OAuth2 授權，讓應用程式能代表使用者與網路服務互動。OAuth2 可以讓 AdMob API 用戶端應用程式存取使用者的 AdMob 帳戶，無需處理或儲存使用者的使用者名稱和密碼。如需授權總覽，請參閱授權。

請執行下列步驟來產生 OAuth2 憑證，並提出第一個要求。

必要條件

• Google 帳戶。

• Google AdMob 帳戶。

• 熟悉 REST 基本概念和使用 OAuth 2.0 授權要求。

決定驗證類型

請參閱下表，瞭解哪種驗證類型最適合您的應用程式：

選擇 OAuth2 驗證類型	適用條件
電腦版應用程式	您是透過單一頂層管理員帳戶管理所有 AdMob API 帳戶。 您是第一次使用，或想要以最簡單的設定快速上手。 您的應用程式只會在一台電腦上驗證 Google AdMob 使用者。
網頁應用程式	您想要驗證使用者身分，以授予應用程式存取 AdMob API 帳戶資料的權限。 您想要輕鬆產生多個授權憑證，以管理第三方帳戶等等。 您的應用程式需要回呼網址。電腦版應用程式流程不支援回呼網址。

重點提示： 即使您正在開發在伺服器上執行的應用程式，您仍然可以選擇電腦版應用程式流程。差別在於 OAuth 授權是在本機或遠端完成。電腦流程需要在本機機器完成授權，網頁流程則能在 Google 的授權伺服器上完成授權。

建立專案

如要開始使用 AdMob API，您必須先在 Google API 控制台中建立或選取專案，並使用設定工具啟用該 API，工具會引導您完成程序，並自動啟用 AdMob API。

為現有專案啟用 API

下列步驟適用於現有專案，且偏好手動啟用 AdMob API 的使用者。

為您的項目啟用API：

1. Open the API Library中的Google API Console 。
2. If prompted, select a project, or create a new one. API Library列出了所有可用的API，並按產品系列和受歡迎程度分組。
3. 如果您要啟用的API在列表中不可見，請使用搜索找到它，或單擊其所屬產品系列中的“ 查看全部 ”。
4. 選擇要啟用的API，然後單擊“ 啟用”按鈕。
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

建立 OAuth2 憑證

下列操作說明會引導您建立 OAuth 2.0 用戶端 ID，以便與安裝版應用程式流程搭配使用。

1. Go to the Credentials page.

2. 依序點選「建立憑證」>「OAuth 用戶端 ID」。

   如果您尚未為這項專案設定 OAuth 同意畫面，系統會立即引導您。按一下「設定同意畫面」。您可以透過多種方式設定同意畫面使用 OAuth 2.0 用戶端 ID，

   1. 將使用者類型設為「External」(外部)，並將狀態設為「Publish」(發布)。

   2. 您也可以將使用者類型設為「External」(外部)，並將狀態設為「Testing」(測試)，然後選取「Add users」(新增使用者)，藉此新增「Test 位使用者」，讓他們存取您的 OAuth 2.0 用戶端 ID。

      詳情請參閱「設定 OAuth 同意畫面」。

3. 將應用程式類型設為「Desktop app」或「Web Application」，為其命名，然後按一下「Create」。

完成後，系統會顯示 OAuth 2.0 用戶端 ID 和用戶端密鑰，您可以使用 JSON 格式下載並儲存用戶端密鑰，以供日後使用。

提出要求

AdMob API 是以 HTTP 和 JSON 為基礎，因此所有標準 HTTP 用戶端都可以向這個 API 傳送要求，並剖析回應。不過，Google API 用戶端程式庫能提供更優異的語言整合能力、提升安全性，並支援提出授權要求。用戶端程式庫支援多種程式設計語言，只要善加利用，您就不必再手動設定 HTTP 要求及剖析回應。

注意： 第一次啟用 OAuth 流程時，系統會要求您提供 AdMob 發布商 ID，並在瀏覽器中接受授權提示。接受邀請前，請確認您登入的 Google 帳戶可存取您的 AdMob 帳戶。這樣一來，您的應用程式就會以目前登入的帳戶的身分存取資料。

建立 OAuth 2.0 憑證後，即可開始使用 AdMob API。如要使用 OAuth 2.0 要求存取權，應用程式還需要範圍資訊：

範圍	意義
https://www.googleapis.com/auth/admob.readonly	查看所有 AdMob 資料。當中可能包含帳戶資訊、廣告空間和中介服務設定、報表和其他資料。 但不含付款或廣告活動詳細資料等機密資料。
https://www.googleapis.com/auth/admob.report	查看廣告成效和收益報表。查看發布商 ID、 時區和預設貨幣代碼。

發出第一個要求，以使用 Java、PHP、Python 或 curl 的範例產生報表。

撤銷共用權杖

您可以透過下列兩種方式撤銷共用權杖：

1. 前往 Google 帳戶權限頁面，撤銷相關專案的存取權。

2. 或者，您也可以使用 Google Identity API 撤銷網頁應用程式權杖。