FetchAndJoinCustomAudienceRequest

public final class FetchAndJoinCustomAudienceRequest
extends Object

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


用于封装提取 CustomAudience 所需的必需参数和可选参数的请求对象。

fetchUri 是唯一的必需参数,表示要从中提取自定义受众群体的 URI。nameactivationTimeexpirationTimeuserBiddingSignals 都是可选参数;代表一部分自定义受众群体,可供调用方用来判断应将用户添加到哪个自定义受众群体。从 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 引用值 xx.equals(x) 应返回 true
  • 该方法具有对称性:对于任何非 null 引用值 xy,当且仅当 y.equals(x) 返回 true 时,x.equals(y) 才应返回 true
  • 该方法具有传递性:对于任何非 null 引用值 xyz,如果 x.equals(y) 返回 truey.equals(z) 返回 true,则 x.equals(z) 应返回 true
  • 该方法具有一致性:对于任何非 null 引用值 xy,多次调用 x.equals(y) 时,只要没有修改对象的 equals 比较中使用的任何信息,就会一致地返回 truefalse
  • 对于任何非 null 引用值 xx.equals(null) 应返回 false

Object 类的 equals 方法可对对象实现最具辨别性的等价关系;也就是说,对于任何非 null 引用值 xy,当且仅当 xy 引用同一对象时,此方法才会返回 truex == 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 方法会返回一个“以文本形式表示”此对象的字符串。结果应该是一个简洁但信息丰富,并且便于阅读的字符串表示。建议所有子类都覆盖此方法。

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

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

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