所有 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 程式庫」 API Library 會列出所有可用的 API,並按照產品系列及熱門程度分組。
- 如果清單裡找不到您想啟用的 API,請使用搜尋功能,或點選所屬產品系列的「查看全部」。
- 選取要啟用的 API,然後按一下「Enable」按鈕。
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
建立 OAuth2 憑證
請按照下列操作說明,建立 OAuth 2.0 用戶端 ID,以便搭配已安裝應用程式流程使用。
- Go to the Clients page.
依序點選「建立憑證」>「OAuth 用戶端 ID」。
如果您先前未設定這個專案的 OAuth 同意畫面,系統會引導您進行設定。點選「設定同意畫面」。您可以透過多種方式設定同意畫面,以使用 OAuth 2.0 用戶端 ID。
- 將使用者類型設為「外部」,發布狀態設為「已發布」。
或者,將使用者類型設為「外部」,發布狀態設為「測試」,然後選取「新增使用者」,新增「測試使用者」,讓他們有權使用您的 OAuth 2.0 用戶端 ID。
進一步瞭解如何設定 OAuth 同意畫面。
將應用程式類型設為「Desktop app」(桌面應用程式) 或「Web Application」(網頁應用程式),為應用程式命名,然後按一下「Create」(建立)。
完成後,系統會顯示 OAuth 2.0 用戶端 ID 和用戶端密鑰,您可以下載 JSON 格式並儲存,以供日後使用。
提出要求
AdMob API 是以 HTTP 和 JSON 做為建構基礎,因此所有標準 HTTP 用戶端都可以向 AdMob API 傳送要求並剖析回應。不過,Google API 用戶端程式庫不但提供更出色的語言整合功能,安全性也更高,還能發出授權要求。用戶端程式庫支援多種程式語言,只要善加利用,您就不必再手動設定 HTTP 要求及剖析回應。
建立 OAuth 2.0 憑證後,即可開始使用 AdMob API。如要透過 OAuth 2.0 要求存取權,您的應用程式也需要範圍資訊:
範圍 | 意義 |
---|---|
https://www.googleapis.com/auth/admob.readonly |
查看所有 AdMob 資料。這些 AdMob 資料可能包含您的帳戶資訊、廣告空間和中介服務設定、報表以及其他資料,但不含付款或廣告活動詳細資料等這類機密資料。 |
https://www.googleapis.com/auth/admob.report |
查看廣告成效和收益報表。查看發布商 ID、時區和預設貨幣代碼。 |
使用 Java、PHP、Python 或 curl 中的範例,發出第一個要求來產生報表。
撤銷共用權杖
您可以使用下列兩種方式撤銷共用權杖:
前往 Google 帳戶權限頁面,然後撤銷相關專案的存取權。
或者,您也可以使用 Google Identity API 撤銷網頁應用程式權杖。