本指南旨在協助開發人員利用 AdMob API，以程式輔助方式取得 AdMob 帳戶相關資訊。
所有 Google AdMob API 呼叫都必須透過 OAuth2 授權，讓應用程式能代表使用者與網路服務互動。OAuth2 可以讓 AdMob API 用戶端應用程式存取使用者的 AdMob 帳戶，無需處理或儲存使用者的使用者名稱和密碼。如需授權總覽，請參閱授權。
請執行下列步驟來產生 OAuth2 憑證，並提出第一個要求。
必要條件
決定驗證類型
請參閱下表，瞭解哪種驗證類型最適合您的應用程式：
| 選擇 OAuth2 驗證類型 | 適用條件 |
|---|---|
| 電腦版應用程式 |
|
| 網頁應用程式 |
|
建立專案
如要開始使用 AdMob API，您必須先在 Google API 控制台中建立或選取專案，並使用設定工具啟用該 API，工具會引導您完成程序，並自動啟用 AdMob API。
為現有專案啟用 API
下列步驟適用於現有專案，且偏好手動啟用 AdMob API 的使用者。
為您的項目啟用API：
- Open the API Library中的Google API Console 。
- If prompted, select a project, or create a new one. API Library列出了所有可用的API，並按產品系列和受歡迎程度分組。
- 如果您要啟用的API在列表中不可見，請使用搜索找到它，或單擊其所屬產品系列中的“ 查看全部 ”。
- 選擇要啟用的API，然後單擊“ 啟用”按鈕。
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
建立 OAuth2 憑證
下列操作說明會引導您建立 OAuth 2.0 用戶端 ID，以便與安裝版應用程式流程搭配使用。
- Go to the Credentials page.
依序點選「建立憑證」>「OAuth 用戶端 ID」。
如果您尚未為這項專案設定 OAuth 同意畫面，系統會立即引導您。按一下「設定同意畫面」。您可以透過多種方式設定同意畫面使用 OAuth 2.0 用戶端 ID，
- 將使用者類型設為「External」(外部)，並將狀態設為「Publish」(發布)。
您也可以將使用者類型設為「External」(外部)，並將狀態設為「Testing」(測試)，然後選取「Add users」(新增使用者)，藉此新增「Test 位使用者」，讓他們存取您的 OAuth 2.0 用戶端 ID。
詳情請參閱「設定 OAuth 同意畫面」。
將應用程式類型設為「Desktop app」或「Web Application」，為其命名，然後按一下「Create」。
完成後，系統會顯示 OAuth 2.0 用戶端 ID 和用戶端密鑰，您可以使用 JSON 格式下載並儲存用戶端密鑰，以供日後使用。
提出要求
AdMob API 是以 HTTP 和 JSON 為基礎，因此所有標準 HTTP 用戶端都可以向這個 API 傳送要求，並剖析回應。不過，Google API 用戶端程式庫能提供更優異的語言整合能力、提升安全性，並支援提出授權要求。用戶端程式庫支援多種程式設計語言，只要善加利用，您就不必再手動設定 HTTP 要求及剖析回應。
建立 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 的範例產生報表。
撤銷共用權杖
您可以透過下列兩種方式撤銷共用權杖：
前往 Google 帳戶權限頁面，撤銷相關專案的存取權。
或者，您也可以使用 Google Identity API 撤銷網頁應用程式權杖。