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 のすべてのデータを表示します。これには、アカウント情報、広告枠設定、メディエーション設定、レポートなどのデータが含まれる場合があります。また、支払いやキャンペーンの詳細などの機密データは含まれません。

curl（コマンドライン）

curl を使用したリクエスト

  1. Secrets ファイルを読み込み、認証情報を生成します。

    この手順を初めて行う際には、認証を求めるメッセージがブラウザに表示されます。承認する前に、AdMob API へのアクセス権を持つ Google アカウントでログインしていることをご確認ください。現在ログインしているアカウントに代わって、アプリがデータにアクセスすることが認証されます。

    認証と認可には、Google OAuth 2.0 を操作するためのシンプルなコマンドライン ツールである oauth2l を使用することをおすすめします。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"
     }]
  }]
}