Adapters

AdMob API 可透過程式輔助方式列出中介服務適配器，詳情請參閱 accounts.adSources.adapters.list。轉接程式包含第三方轉接程式設定的詳細資料。

範例

建立 OAuth 2.0 憑證後，就可以開始使用 AdMob API。如要透過 OAuth 2.0 要求存取權，您的應用程式也需要範圍資訊。

以下是 OAuth 2.0 範圍資訊：

範圍 意義
https://www.googleapis.com/auth/admob.monetization 查看、建立及編輯 AdMob 營利設定。
https://www.googleapis.com/auth/admob.readonly 查看所有 AdMob 資料。這些 AdMob 資料可能包含帳戶資訊、廣告空間和中介服務設定、報表以及其他資料。但不含付款或廣告活動詳細資料等機密資料。

curl (指令列)

使用 curl 提出要求

  1. 載入用戶端密鑰檔案並產生授權憑證。

    首次執行這個步驟時，系統會要求您在瀏覽器中接受授權提示。接受前，請確認您已登入可存取 AdMob API 的 Google 帳戶。您的應用程式將獲得授權，可代表目前登入的任何帳戶存取資料。

    如要進行驗證和授權，建議您使用 oauth2l，這是可搭配 Google OAuth 2.0 使用的簡易指令列工具。安裝 oauth2l 並執行下列指令，將 path_to_credentials_json 替換為註冊雲端應用程式時下載的 credentials.json 檔案路徑。首次執行時，指令會引導您完成 OAuth 2.0 授權流程。完成後，系統就會自動重新整理權杖。

    oauth2l header --json path_to_credentials_json --scope admob.readonly

  2. 列出轉接器。

    將 pub-XXXXXXXXXXXXXXXX 替換為發布商 ID，即可取得 AdMob 轉接器資訊，請參閱這篇文章，瞭解如何查看發布商 ID。

    將 SSSSSSSSSSSSSSSSSSSS 替換為您感興趣的轉接程式廣告來源 ID。

    請使用下列指令取得轉接器清單：

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    以下是 ID 為 5450213213286189855 的 AdMob 聯播網廣告來源的回應範例：

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}