広告 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 のインスタンスを作成する

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

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())