ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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


ProtectedSignalsManager proporciona APIs para apps y SDKs de anuncios para administrar sus indicadores protegidos.

Resumen

Métodos públicos

static ProtectedSignalsManager get(Context context)

Método de fábrica para crear una instancia de ProtectedSignalsManager.

void updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<ObjectException> receiver)

La API de updateSignals recuperará un JSON del URI que describe qué indicadores agregar o quitar.

Métodos heredados

Métodos públicos

get

public static ProtectedSignalsManager get (Context context)

Método de fábrica para crear una instancia de ProtectedSignalsManager.

Parámetros
context Context: El Context que se usará. Este valor no puede ser null.

Devuelve
ProtectedSignalsManager Una instancia de ProtectedSignalsManager. Este valor no puede ser null.

updateSignals

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

La API de updateSignals recuperará un JSON del URI que describe qué indicadores agregar o quitar. Esta API también permite registrar el extremo del codificador. El extremo se usa para descargar una lógica de codificación, que permite codificar los indicadores.

Las claves de nivel superior del JSON deben corresponder a uno de los 5 comandos:

"put": Agrega una nueva señal y reemplaza cualquier señal existente con la misma clave. El valor de esto es un objeto JSON en el que las claves son strings de base 64 correspondientes a la clave que se debe poner y los valores son cadenas de base 64 que corresponden al valor que se va a colocar.

"Agregar": Agrega un indicador o indicadores nuevos a una serie temporal de indicadores y quita los más antiguos para hacer lugar a los nuevos si el tamaño de la serie supera el máximo determinado. El valor de esto es un objeto JSON en el que las claves son strings de base 64 correspondientes a la clave que se agrega y los valores son objetos con dos campos: "values" y "maxSignals" . "valores" es una lista de cadenas de base 64 correspondientes a los valores de indicador para agregar a las series temporales. "maxSignals" es la cantidad máxima de valores permitidos en esta serie temporal. Si la cantidad actual de indicadores asociados con la clave supera a maxSignals, se quitarán los indicadores más antiguos. Ten en cuenta que puedes adjuntarlo a una clave add by put. Si agregas más de la cantidad máxima de valores, se producirá un error.

"put_if_not_present": Agrega un indicador nuevo solo si no existen indicadores con la misma clave. El valor de esto es un objeto JSON en el que las claves son strings de base 64 correspondientes a la clave que se va a poner y los valores son strings de base 64 que corresponden al valor que se va a colocar.

"remove": Quita la señal de una clave. El valor es una lista de strings de base 64 que corresponde a las claves de los indicadores que se deben borrar.

"update_encoder": Proporciona una acción para actualizar el extremo y un URI que se puede usar a fin de recuperar una lógica de codificación. La subclave para proporcionar una acción de actualización es "action" y los valores admitidos actualmente son los siguientes:

  1. “REGISTER”: Registra el extremo del codificador si se proporciona por primera vez o reemplaza el existente por el extremo proporcionado recientemente. Se requiere proporcionar el “extremo” para la acción “REGISTER”.

La subclave para proporcionar un extremo del codificador es "endpoint" y el valor es la string del URI para el extremo.

Solo se puede operar la clave con un comando por JSON. Si dos comandos intentan operar en la misma clave, este método mediante un IllegalArgumentException

La llamada falla con un SecurityException si

  1. ownerPackageName no llama al nombre del paquete de la app.
  2. el comprador no está autorizado a usar la API.

La llamada falla con un IllegalArgumentException si

  1. El JSON recuperado del servidor no es válido.
  2. El URI proporcionado no es válido.

Esta llamada falla con LimitExceededException si el paquete de llamada supera los límites de frecuencia permitidos y se limita.

Esta llamada falla con una IllegalStateException si se encuentra un error interno del servicio.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parámetros
updateSignalsRequest UpdateSignalsRequest: Este valor no puede ser null.

executor Executor: Este valor no puede ser null. Los eventos de devolución de llamada y de objetos de escucha se envían a través de este Executor, lo que proporciona una manera fácil de controlar qué subproceso se usa. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor(). De lo contrario, proporciona un Executor que se envíe al subproceso correspondiente.

receiver OutcomeReceiver: Este valor no puede ser null.