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，多次调用 x.equals(y) 时，只要没有修改对象的 equals 比较中使用的任何信息，就会一致地返回 true 或 false。
  • 对于任何非 null 引用值 x，x.equals(null) 应返回 false。

Object 类的 equals 方法可对对象实现最具辨别性的等价关系；也就是说，对于任何非 null 引用值 x 和 y，当且仅当 x 和 y 引用同一对象时，此方法才会返回 true（x == y 时值为 true）。

请注意，一般而言，每次替换此方法时，都需要替换 hashCode 方法，以便维持 hashCode 方法的通用协定，该协定规定相等的对象必须具有相等的哈希代码。

参数
o Object：用来进行比较的参照对象。
返回值
boolean true：仅当两个 FetchAndJoinCustomAudienceRequest 对象包含相同的信息时。

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 自定义 受众群体参与广告选择。 此值可以为 null。

hashCode

public int hashCode ()

返回对象的哈希代码值。之所以支持此方法，是为了支持哈希表（例如由 HashMap 提供的表）。

hashCode 的通用协定如下：

  • 每当在 Java 应用执行期间在同一个对象上多次调用该方法时，只要没有修改对象的 equals 比较中使用的任何信息，hashCode 方法都必须始终返回相同的整数。在应用的不同执行之间，此整数无需保持一致。
  • 如果根据 equals(Object) 方法判断两个对象相等，则对这两个对象分别调用 hashCode 方法必须产生相同的整数结果。
  • 而如果根据 equals(java.lang.Object) 方法判断两个对象不相等，将不要求对这两个对象分别调用 hashCode 方法必须产生不同的整数结果。但是，程序员应注意，为不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的前提下，由 Object 类定义的 hashCode 方法确实会针对不同的对象返回不同的整数。（hashCode 不一定会在某个时间点作为对象内存地址的某个函数实现。）

返回值
int FetchAndJoinCustomAudienceRequest 对象数据的哈希值。

toString

public String toString ()

返回对象的字符串表示。通常，toString 方法会返回一个“以文本形式表示”此对象的字符串。结果应该是一个简洁但信息丰富，并且便于阅读的字符串表示。建议所有子类都覆盖此方法。

类 Object 的 toString 方法会返回一个字符串，其中包含类的名称（相应对象是此类的实例）、字符“@”，以及此对象哈希代码的无符号十六进制表示。也就是说，此方法所返回的字符串等于以下公式的值： 

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

返回值
String 以人类可读的方式表示的 FetchAndJoinCustomAudienceRequest。