Gerenciador de sinais-protegidos

public class ProtectedSignalsManager
extends Object

java.lang.Object
   ↳ android.adservices.signals.ProtectedSignalsManager


A ProtectedSignalsManager fornece 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 de fábrica 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 de fábrica para criar uma instância de ProtectedSignalsManager.

Parâmetros
context Context: o Context a ser usado. Esse valor não pode ser null.

Retorna
ProtectedSignalsManager Uma instância ProtectedSignalsManager Esse valor não pode ser null.

updateSignals

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 destes cinco comandos:

“colocar” - Adiciona um novo indicador, substituindo qualquer indicador existente 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 for e os valores são uma string de base 64 correspondente ao valor a ser colocado.

"anexar" - Anexa novos indicadores a uma série temporal de indicadores, removendo os mais antigos para dar espaço aos novos quando o tamanho da série excede o máximo determinado. O valor para isso é um objeto JSON em que as chaves são strings de base 64 correspondentes ao chave para anexar e os valores são objetos com dois campos: "values" e "maxSignals" , "valores" é uma lista de strings de base 64 correspondentes aos valores de indicadores que serão anexados ao horário. Google Workspace. "maxSignals" é o número máximo de valores permitidos nesta série temporal. Se o número atual de indicadores associados à chave excede "maxSignals" os indicadores mais antigos será removido. É possível anexar a uma chave adicionada por put. Não que seja acrescentando o número máximo de valores vai causar uma falha.

"put_se_não_presente" - Adiciona um novo indicador somente se não houver indicadores existentes com o mesma chave. O valor para isso é um objeto JSON em que as chaves são strings de base 64 correspondente à chave a ser colocada e os valores são uma string de base 64 correspondente ao que será usado.

"remover" - Remove o sinal de uma chave. O valor disso é uma lista de strings de base 64. correspondentes às chaves dos indicadores que precisam ser excluídos.

"update_encoder" - Oferece 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 é "ação" e o compatíveis atualmente são:

  1. "INSCREVER-SE" : registra o endpoint do codificador se ele for fornecido pela primeira vez ou substitui o atual pelo endpoint recém-fornecido. Fornecer o "endpoint" é necessário para a entrada "REGISTER" à ação.

A subchave para fornecer um endpoint do codificador é "endpoint" e o valor é o URI para o endpoint.

A chave só pode ser operada por um comando por JSON. Se dois comandos tentarem operar a mesma chave, esse método fará uma solicitação IllegalArgumentException

Esta chamada vai falhar com um SecurityException se

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

Esta chamada vai falhar com um IllegalArgumentException se

  1. O JSON recuperado do servidor não é válido.
  2. O URI fornecido é inválido.

Esta chamada falhará com LimitExceededException se o pacote de chamada exceder o os limites de taxa permitidos e é limitada.

Esta chamada vai falhar com um IllegalStateException se for um erro de serviço interno encontrados.
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 retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar 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.