広告 ID

関連項目:

• AdIdManager.getAdId(Executor, OutcomeReceiver)

ゼロ出力

public static final String ZERO_OUT

ユーザーが limited ad tracking を持っている場合に返される、ゼロアウトされた ad id。

定数値: "00000000-0000-0000-0000-000000000000"

広告 ID

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

AdId のインスタンスを作成します。

次と等しい

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 メソッドをオーバーライドする必要があります。

getAdId

public String getAdId ()

広告 ID。

アドバタイジング ID の値は、isLimitAdTrackingEnabled() と AdServicesPermissions.ACCESS_ADSERVICES_AD_ID の組み合わせによって異なります。

ユーザーが limiting ad tracking の場合、API は ZERO_OUT を返します。この場合、呼び出し元は、収益化を目的としてユーザーを追跡することはできません。

それ以外の場合は、デバイスとユーザーに固有の文字列が返されます。この文字列は、広告でユーザーを追跡するために使用できます。

hashCode

public int hashCode ()

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

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

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

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

isLimitAdTrackingEnabled

public boolean isLimitAdTrackingEnabled ()

有効な広告トラッキング制限の設定を取得します。

この値は、ユーザーが広告トラッキング制限を有効にしている場合は true、そうでない場合は false です。

toString

public String toString ()

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

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

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