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<ObjectException> 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<ObjectException> 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:

  1. "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

  1. o ownerPackageName não estiver chamando o nome do pacote do app e/ou
  2. o comprador não está autorizado a usar a API.

A chamada vai falhar com um IllegalArgumentException se

  1. O JSON recuperado do servidor não é válido.
  2. 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.