ProtectedSignalsManager
public
class
ProtectedSignalsManager
extends Object
java.lang.Object (link em inglês) | |
↳ | android.adservices.signals.ProtectedSignalsManager |
A ProtectedSignalsManager oferece APIs para que apps e SDKs de anúncios gerenciem os indicadores protegidos.
Resumo
Métodos públicos | |
---|---|
static
ProtectedSignalsManager
|
get(Context context)
Método Factory para criar uma instância de ProtectedSignalsManager. |
void
|
updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
A API updateSignals recuperará um JSON do URI que descreve quais indicadores adicionar ou remover. |
Métodos herdados | |
---|---|
Métodos públicos
get
public static ProtectedSignalsManager get (Context context)
Método Factory para criar uma instância de ProtectedSignalsManager.
Parâmetros | |
---|---|
context |
Context : o Context a ser usado.
Esse valor não pode ser null . |
Returns | |
---|---|
ProtectedSignalsManager |
Uma instância ProtectedSignalsManager
Esse valor não pode ser null . |
Indicadores de atualização
public void updateSignals (UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
A API updateSignals recuperará um JSON do URI que descreve quais indicadores adicionar ou remover. Essa API também permite registrar o endpoint do codificador. O endpoint é usado para fazer o download de uma lógica de codificação, que permite a codificação dos sinais.
As chaves de nível superior do JSON precisam corresponder a um dos cinco comandos:
"put": adiciona um novo sinal, substituindo todos os sinais existentes com a mesma chave. O valor para isso é um objeto JSON em que as chaves são strings de base 64 correspondentes à chave a ser colocada, e os valores são strings de base 64 correspondentes ao valor a ser colocado.
"anexar": anexa um novo sinal/sinais a uma série temporal de sinais, removendo os sinais mais antigos para dar espaço aos novos se o tamanho da série exceder o máximo determinado. O valor desse atributo é um objeto JSON em que as chaves são strings de base 64 correspondentes à chave a ser anexada, e os valores são objetos com dois campos: "values" e "maxSignals" . "values" é uma lista de strings de base 64 correspondentes a valores de indicadores a serem anexados à série temporal. "maxSignals" é o número máximo de valores permitidos nessa série temporal. Se o número atual de sinais associados à chave exceder maxSignals, os sinais mais antigos serão removidos. É possível anexar a uma chave adicionada por put. Incluir mais valores do que o número máximo não causará falha.
"put_if_not_present": adiciona um novo sinal somente se não houver nenhum com a mesma chave. O valor desse objeto é um objeto JSON em que as chaves são strings de base 64 correspondentes à chave a ser colocada, e os valores são strings de base 64 correspondentes ao valor a ser colocado.
"remove": remove o sinal de uma chave. O valor disso é uma lista de strings de base 64 correspondentes às chaves dos sinais que precisam ser excluídos.
"update_encoder": fornece uma ação para atualizar o endpoint e um URI que pode ser usado para recuperar uma lógica de codificação. A subchave para fornecer uma ação de atualização é "action" e os valores atualmente compatíveis são:
- "REGISTER" : registra o endpoint do codificador, se fornecido pela primeira vez, ou substitui o endpoint atual pelo novo. É necessário fornecer o "endpoint" para a ação "REGISTER".
A subchave para fornecer um endpoint do codificador é "endpoint", e o valor é a string do URI para o endpoint.
A chave só pode ser operada por um comando por JSON. Se dois comandos tentarem operar na
mesma chave, esse método usará um IllegalArgumentException
A chamada vai falhar com um SecurityException
se
- o
ownerPackageName
não estiver chamando o nome do pacote do app e/ou - o comprador não está autorizado a usar a API.
A chamada vai falhar com um IllegalArgumentException
se
- O JSON recuperado do servidor não é válido.
- O URI informado é inválido.
Essa chamada vai falhar com LimitExceededException
se o pacote de chamada exceder os
limites de taxa permitidos e for limitado.
Essa chamada vai falhar com um IllegalStateException
se um erro interno de serviço for
encontrado.
Requer AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
Parâmetros | |
---|---|
updateSignalsRequest |
UpdateSignalsRequest : este valor não pode ser null . |
executor |
Executor : este valor não pode ser null .
Eventos de callback e listener são enviados por esse
Executor , oferecendo uma maneira fácil de controlar qual linha de execução é
usada. Para enviar eventos com a linha de execução principal do
aplicativo, use
Context.getMainExecutor() .
Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada. |
receiver |
OutcomeReceiver : este valor não pode ser null . |