FetchAndJoinCustomAudienceRequest

public final class FetchAndJoinCustomAudienceRequest
extends Object

java.lang.Object
   ↳ android.adservices.customaudience.FetchAndJoinCustomAudienceRequest

CustomAudience のフェッチに必要とされる、必須パラメータとオプション パラメータをラップするリクエスト オブジェクトです。

fetchUri が唯一の必須パラメータで、カスタム オーディエンスのフェッチ元の URI を表します。name、activationTime、expirationTime、userBiddingSignals は省略可能なパラメータです。これらは部分的なカスタム オーディエンスを表し、呼び出し元はこれを使用して、ユーザーを追加すべきカスタム オーディエンスの選択を通知できます。呼び出し元が設定したフィールドは、fetchUri からフェッチしたカスタム オーディエンスでオーバーライドできません。各フィールドの詳細については、CustomAudience をご覧ください。

概要

ネストされたクラス

class FetchAndJoinCustomAudienceRequest.Builder

FetchAndJoinCustomAudienceRequest オブジェクトのビルダー。 

パブリック メソッド

boolean equals(Object o)

他のオブジェクトが「次と等しい」かどうかを示します。表示されます。

Instant getActivationTime()

詳しくは、CustomAudience#getActivationTime() をご覧ください。

Instant getExpirationTime()

詳しくは、CustomAudience#getExpirationTime() をご覧ください。

Uri getFetchUri()
String getName()

詳しくは、CustomAudience#getName() をご覧ください。

AdSelectionSignals getUserBiddingSignals()

詳しくは、CustomAudience#getUserBiddingSignals() をご覧ください。

int hashCode()

オブジェクトのハッシュコード値を返します。

String toString()

オブジェクトの文字列表現を返します。

継承されるメソッド

パブリック メソッド

equals

public boolean equals (Object o)

他のオブジェクトがこのオブジェクトと「等しい」かどうかを示します。

equals メソッドは、null 以外のオブジェクト参照に等価関係を実装します。

  • 再帰性: null 以外の参照値 x について、x.equals(x) は true を返します。
  • 対称性: null 以外の参照値 x、y について、y.equals(x) が true を返す場合にのみ、x.equals(y) は true を返します。
  • 推移性: null 以外の参照値 x、y、z について、x.equals(y) が true を返し、かつ y.equals(z) が true を返す場合、x.equals(z) は true を返します。
  • 一貫性: null 以外の参照値 x、y について、オブジェクトの equals 比較に使用する情報が変更されない限り、何度 x.equals(y) を呼び出しても返される値は一貫して true か、一貫して false です。
  • null 以外の参照値 x について、x.equals(null) は false を返します。

Object クラスの equals メソッドは、オブジェクトの等価関係を可能な限り識別しやすく実装します。つまり、null 以外の参照値 x と y について、x と y が同じオブジェクトを参照している場合にのみ、true を返します（x == y の値は true）。

なお、等しいオブジェクトは等しいハッシュコードを持たなければならないという hashCode メソッドの一般的なコントラクトを維持するよう、通常はこのメソッドがオーバーライドされるたびに hashCode メソッドをオーバーライドする必要があります。

パラメータ
o Object: 比較対象の参照オブジェクト。
戻り値
boolean 2 つの FetchAndJoinCustomAudienceRequest オブジェクトに同じ情報が含まれている場合にのみ true です。

getActivationTime

public Instant getActivationTime ()

詳しくは、CustomAudience#getActivationTime() をご覧ください。

戻り値
Instant カスタム オーディエンスへの参加を遅らせる Instant。 この値は null であっても構いません。

getExpirationTime

public Instant getExpirationTime ()

詳しくは、CustomAudience#getExpirationTime() をご覧ください。

戻り値
Instant カスタム オーディエンスのメンバーシップが期限切れになる Instant。 この値は null であっても構いません。

getFetchUri

public Uri getFetchUri ()

戻り値
Uri カスタム オーディエンスのフェッチ元となる Uri です。 この値が null になることはありません。

getName

public String getName ()

詳しくは、CustomAudience#getName() をご覧ください。

戻り値
String 参加するカスタム オーディエンスの String 名。 この値は null であっても構いません。

getUserBiddingSignals

public AdSelectionSignals getUserBiddingSignals ()

詳しくは、CustomAudience#getUserBiddingSignals() をご覧ください。

戻り値
AdSelectionSignals カスタムアクションイベント発生時に 購入者提供の JavaScript で消費される ユーザーが広告選択に参加したとき この値は null であっても構いません。

hashCode

public int hashCode ()

オブジェクトのハッシュコード値を返します。このメソッドは、HashMap で実現するようなハッシュ テーブルの利点を活かすためにサポートされています。

hashCode の一般的なコントラクトは次のとおりです。

  • Java アプリの実行中に同じオブジェクトに対して複数回呼び出された場合、オブジェクトの equals 比較に使用される情報が変更されない限り、hashCode メソッドは一貫して同じ整数を返さなければなりません。この整数は、アプリのある実行から同じアプリの別の実行まで一貫している必要はありません。
  • equals(Object) メソッドから 2 つのオブジェクトが等しい場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、同じ整数の結果が生成されなければなりません。
  • equals(java.lang.Object) メソッドから 2 つのオブジェクトが等しくない場合、その 2 つのオブジェクトのそれぞれに対して hashCode メソッドを呼び出したとき、異なる整数の結果が生成されなければならない、ということはありません。ただし、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ テーブルのパフォーマンスが向上する可能性があることに留意すべきです。

現実的である限り、クラス Object で定義された hashCode メソッドは、異なるオブジェクトに対して異なる整数を返します（hashCode は、ある時点からオブジェクトのメモリアドレスの関数として実装されるかもしれません）。

戻り値
int FetchAndJoinCustomAudienceRequest オブジェクトのデータのハッシュです。

toString

public String toString ()

オブジェクトの文字列表現を返します。toString メソッドは一般に、オブジェクトを「テキストで表現」した文字列を返します。結果は、簡潔でありながら情報量の多い表現になり、人が簡単に読むことができます。すべてのサブクラスでこのメソッドをオーバーライドすることをおすすめします。

クラス Object の toString メソッドは、オブジェクトがインスタンスになっているクラスの名前、アットマーク文字「@」、オブジェクトのハッシュコードの符号なし 16 進表現で構成される文字列を返します。つまり、このメソッドは以下の値のような文字列を返します。

 getClass().getName() + '@' + Integer.toHexString(hashCode())

戻り値
String FetchAndJoinCustomAudienceRequest を人が読める形式で表現したものです。