ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

java.lang.Object
   ↳ android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager は、アプリと広告 SDK が保護されたシグナルを管理するための API を提供します。

概要

パブリック メソッド

static ProtectedSignalsManager get(Context context)

ProtectedSignalsManager のインスタンスを作成するためのファクトリ メソッド。

void updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)

updateSignals API は、追加するシグナルを記述した JSON を URI から取得します。 できます。

継承されるメソッド

パブリック メソッド

get

public static ProtectedSignalsManager get (Context context)

ProtectedSignalsManager のインスタンスを作成するためのファクトリ メソッド。

パラメータ
context Context: 使用する Context この値が null になることはありません。
戻り値
ProtectedSignalsManager ProtectedSignalsManager インスタンス この値が null になることはありません。

updateSignals

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

updateSignals API は、追加するシグナルを記述した JSON を URI から取得します。 できます。この API では、エンコーダ エンドポイントを登録することもできます。エンドポイントは、 信号のエンコードを可能にするエンコード ロジックをダウンロードする。

JSON の最上位キーは、次の 5 つのコマンドのいずれかに対応する必要があります。

「put」- 新しいシグナルを追加し、同じキーで既存のシグナルを上書きします。この値 これは JSON オブジェクトで、キーは追加するキーに対応する Base 64 文字列です。 値は入力する値に対応する Base 64 文字列です。

「追加」- 時系列のシグナルに新しいシグナルを追加して、最も古いものを削除する シグナルを削除して、新しいシグナルのスペースを確保します。 この値は JSON オブジェクトで、キーは 追加先のキー。値は「values」という 2 つのフィールドを持つオブジェクトです。「maxSignals」をタップします。 "values"時間に追加するシグナル値に対応する Base 64 文字列のリスト シリーズとして提供されます「maxSignals」この時系列で許可される値の最大数です。条件 キーに関連付けられている現在のシグナル数が maxSignals を超えています。最も古いシグナル は削除されます。put によって追加されたキーに追記できます。ただし、 値の最大数を超えるとエラーになります

「put_if_not_present」- 該当する既存のシグナルがない場合にのみ、 あります。この値は、キーが Base 64 文字列の JSON オブジェクト 対応する Key-Value ペアで、値は 指定します。

「remove」- キーのシグナルを削除します。この値は、Base 64 の文字列のリスト 対応するシグナルのキーを返します。

「update_encoder」- エンドポイントを更新するアクション、および エンコード ロジックを取得できます。更新アクションを提供するためのサブキーは「action」ですおよび 現在サポートされている値は次のとおりです。

  1. 「REGISTER」: エンコーダ エンドポイントを初めて指定する場合は登録します。 既存のエンドポイントが、新しく指定されたエンドポイントで上書きされます。「エンドポイント」を提供する "REGISTER" には必須できます。

エンコーダ エンドポイントを指定するためのサブキーは「endpoint」値は URI エンドポイント用の文字列です。

キーを操作できるのは、JSON ごとに 1 つのコマンドのみです。2 つのコマンドを同じ Pod に対して 同じ鍵の場合、このメソッドでは IllegalArgumentException が使用されます。

次の場合、この呼び出しは SecurityException で失敗します。

  1. ownerPackageName がアプリのパッケージ名を呼び出していない
  2. 購入者に API の使用権限がありません。

次の場合、この呼び出しは IllegalArgumentException で失敗します。

  1. サーバーから取得した JSON が無効です。
  2. 指定された URI は無効です。

この呼び出しは、呼び出し元のパッケージがLimitExceededException スロットリングされます。

内部サービスエラーが発生した場合、この呼び出しは IllegalStateException で失敗します。 発生します。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要です

パラメータ
updateSignalsRequest UpdateSignalsRequest: この値を null にすることはできません。
executor Executor: この値を null にすることはできません。 コールバック イベントとリスナー イベントは、この Executor: どのスレッドを表示するかを簡単に制御できます。 分析できますアプリケーションのメインスレッドを介してイベントをディスパッチするには、 作成する場合は、 Context.getMainExecutor()。 それ以外の場合は、適切なスレッドにディスパッチする Executor を提供します。
receiver OutcomeReceiver: この値を null にすることはできません。