MobileAds

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Google Mobile Ads SDK のデフォルトのエラー ドメイン名。

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

initialize または最初の広告リクエストの前に呼び出して、メディエーション アダプタの初期化を無効にします。このメソッドは、initialize または最初の広告リクエストが実行されると、無効になります。

警告: このメソッドを呼び出すと、メディエーションのパフォーマンスに悪影響を及ぼす可能性があります。このメソッドは、アプリにメディエーション アダプターが含まれているが、このアプリ セッション中に Google メディエーションを使用する予定がない場合にのみ呼び出す必要があります（A/B テストを実施している場合など）。

java-static fun getInitializationStatus(): InitializationStatus?

SDK の初期化ステータスを取得します。

java-static fun getRequestConfiguration(): RequestConfiguration

グローバル RequestConfiguration を取得します。

java-static fun getVersion(): VersionInfo!

Google Mobile Ads SDK の外部バージョン（20.6.0 など）を取得します。

この関数を呼び出す前に initialize を呼び出す必要はありません。

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Google Mobile Ads SDK を初期化します。

セッションの最初の広告リクエストのレイテンシを短縮するには、アプリの起動後できるだけ早くこのメソッドを呼び出してください。

このメソッドが呼び出されなかった場合、最初の広告リクエストで Google Mobile Ads SDK が自動的に初期化されます。

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Google Mobile Ads SDK を初期化します。

セッションの最初の広告リクエストのレイテンシを短縮するには、アプリの起動後できるだけ早くこのメソッドを呼び出してください。

このメソッドが呼び出されなかった場合、最初の広告リクエストで Google Mobile Ads SDK が自動的に初期化されます。

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

広告インスペクタの UI が開きます。

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

デバッグ メニューが開きます。この関数は、initialize の呼び出し前に呼び出す必要があります。

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

Google Mobile Ads SDK のパブリッシャーのファーストパーティ ID（旧称「同一アプリキー」）を有効にするかどうかを制御します。

この ID はデフォルトで有効になっています。無効にすると、設定はアプリ セッション間で保持され、ID はクリアされます。

この関数は、initialize の呼び出し前に呼び出す必要があります。

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

Google Mobile Ads SDK に CustomTabsClient を登録して、この CustomTabsSession 内の広告のアプリ内広告収益化を改善します。これにより、CustomTabsSession のインスタンスが 1 つだけ作成され、これを再実行すると、既存のセッションがオーバーライドされます。

java-static fun registerWebView(webview: WebView): Unit

Google Mobile Ads SDK に WebView を登録して、この WebView 内の広告のアプリ内広告収益化を改善します。

java-static fun setAppMuted(muted: Boolean): Unit

アプリの音声がミュートされているかどうかを示します。すべての広告の初期ミュート状態に影響します。

警告: アプリの音声をミュートすると、配信可能な動画広告が減るため、アプリの広告収益が減少することがあります。この API を利用するのは、アプリがユーザーにカスタム ミュート設定を提供しており、ユーザーが行ったミュート設定をこの API に反映する場合だけにしましょう。

java-static fun setAppVolume(volume: Float): Unit

アプリケーションの音声音量を設定します。他の音声出力と比較したすべての広告の音量に影響します。

警告: アプリの音量を下げると、配信可能な動画広告が減るため、アプリの広告収益が減少することがあります。この API を利用するのは、アプリがユーザーにカスタム音量設定を提供しており、ユーザーが設定した音量が API に反映される場合だけにしましょう。

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

アプリのセッション中にすべての AdRequest で使用されるグローバルな RequestConfiguration を設定します。

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

指定された構成の広告のプリロードを開始します。

広告プリロード API は限定アルファ版です。詳しくは、アカウント マネージャーにお問い合わせください。