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<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 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<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 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:
- "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
ownerPackageName
não esteja chamando o nome do pacote do app e/ou- o comprador não está autorizado a usar a API.
Esta chamada vai falhar com um IllegalArgumentException
se
- O JSON recuperado do servidor não é válido.
- 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 . |