已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入

DeletionRequest.Builder

public static final class DeletionRequest.Builder
extends Object

java.lang.Object
   ↳ android.adservices.measurement.DeletionRequest.Builder


DeletionRequest 对象的构建器。

摘要

公共构造函数

Builder()

公共方法

DeletionRequest build()

构建 DeletionRequest 实例。

DeletionRequest.Builder setDeletionMode(int deletionMode)

设置所提供的参数的匹配行为。

DeletionRequest.Builder setDomainUris(List<Uri> domainUris)

设置将用于匹配的网域 URI 列表。

DeletionRequest.Builder setEnd(Instant end)

设置删除范围的末尾。

DeletionRequest.Builder setMatchBehavior(int matchBehavior)

设置所提供的参数的匹配行为。

DeletionRequest.Builder setOriginUris(List<Uri> originUris)

设置将用于匹配的源 URI 列表。

DeletionRequest.Builder setStart(Instant start)

设置删除范围的开头。

继承的方法

公共构造函数

Builder

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public Builder ()

公共方法

build

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest build ()

构建 DeletionRequest 实例。

返回值
DeletionRequest 此值不能为 null

setDeletionMode

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setDeletionMode (int deletionMode)

设置所提供的参数的匹配行为。DeletionRequest.DELETION_MODE_ALL:所有数据 与所选记录相关联的内容将被删除。DeletionRequest.DELETION_MODE_EXCLUDE_INTERNAL_DATA:除内部系统数据以外的所有数据(例如 速率限制)将被删除。

参数
deletionMode int:值为 DeletionRequest.DELETION_MODE_ALLDeletionRequest.DELETION_MODE_EXCLUDE_INTERNAL_DATA

返回
DeletionRequest.Builder 此值不能为 null

setDomainUris

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setDomainUris (List<Uri> domainUris)

设置将用于匹配的网域 URI 列表。系统会将这些定位条件与 使用同一网域或任何子网域的记录。例如:如果 domainUri 为 https://example.com,则 https://a.example.comhttps://example.comhttps://b.example.com 将匹配;https://abcexample.com 将不匹配。

参数
domainUris List:此值可以为 null

返回值
DeletionRequest.Builder 此值不能为 null

setEnd

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setEnd (Instant end)

设置删除范围的末尾。传入 Instant.MAX 会导致 从指定开始直到要删除的最新记录的所有内容。未设置结束时间 默认为 Instant.MAX

参数
end Instant:此值不能为 null

返回值
DeletionRequest.Builder 此值不能为 null

setMatchBehavior

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setMatchBehavior (int matchBehavior)

设置所提供的参数的匹配行为。DeletionRequest.MATCH_BEHAVIOR_DELETE:这 选项将使用提供的参数(源 URI 和域 URI)为 删除。DeletionRequest.MATCH_BEHAVIOR_PRESERVE:此选项将保留 替换为提供的参数(源 URI 和网域 URI),并选择 删除。

参数
matchBehavior int:值为 DeletionRequest.MATCH_BEHAVIOR_DELETEDeletionRequest.MATCH_BEHAVIOR_PRESERVE

返回
DeletionRequest.Builder 此值不能为 null

setOriginUris

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setOriginUris (List<Uri> originUris)

设置将用于匹配的源 URI 列表。系统会将这些定位条件与 仅使用相同源的记录,即子网域不会匹配。例如:如果 originUri 为 https://a.example.com,则 https://a.example.com 将匹配;https://example.comhttps://b.example.comhttps://abcexample.com 将不匹配。

参数
originUris List:此值可以为 null

返回值
DeletionRequest.Builder 此值不能为 null

setStart

已在 API 级别 34 中引入
也已在广告服务扩展 4 中引入
public DeletionRequest.Builder setStart (Instant start)

设置删除范围的开头。传入 Instant.MIN 会导致 从最早的记录到指定结束的所有内容都会被删除。“未设置”开始 默认为 Instant.MIN

参数
start Instant:此值不能为 null

返回值
DeletionRequest.Builder 此值不能为 null