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: Es el Context que se usará. Este valor no puede ser null.

Muestra
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 habilita la codificación de las señales.

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

“poner” - Agrega un indicador nuevo y reemplaza los existentes con la misma clave. El valor en el que las claves son cadenas de base 64 correspondientes a la clave que se va a colocar y los valores son cadenas de base 64 correspondientes al valor que se va a colocar.

“agregar” - Agrega uno o varios indicadores nuevos a una serie temporal de indicadores, y quita los más antiguos. para incluir 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 cadenas de base 64 correspondientes a la clave para adjuntar, y los valores son objetos con dos campos: “values” y "maxSignals" de Google Cloud. "valores" es una lista de cadenas de base 64 correspondientes a los valores de los indicadores que se agregarán a la hora . “maxSignals” es la cantidad máxima de valores permitidos en esta serie temporal. Si la cantidad actual de indicadores asociados con la clave supera el valor de maxSignals los indicadores más antiguos se eliminará. Ten en cuenta que puedes agregarlo a una clave introducida por put. No es que agregar más de la cantidad máxima de valores causará una falla.

"put_si_no_presente" - Agrega un indicador nuevo solo si no hay indicadores existentes misma clave. El valor es un objeto JSON en el que las claves son cadenas de base 64. correspondiente a la clave que se va a colocar y los valores son la cadena de base 64 correspondiente al valor.

"quitar" - Elimina el indicador de una llave. El valor es una lista de cadenas de base 64 correspondientes 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 para recuperar una lógica de codificación. La subclave para proporcionar una acción de actualización es "action". y las valores admitidos actualmente son los siguientes:

  1. “REGISTRARSE” : Registra el extremo del codificador si se proporciona por primera vez. reemplaza el existente con el extremo proporcionado recientemente. Cómo proporcionar el "extremo" es necesario para la certificación “REGISTER” acción.

La clave secundaria para proporcionar un extremo de codificador es “endpoint”. y el valor es el URI para el extremo.

Solo se puede operar la clave en un comando por JSON. Si dos comandos intentan operar en la misma clave, este método realizará una operación IllegalArgumentException

Esta 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.

Esta 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 que realiza la llamada excede el y los límites de frecuencia permitidos.

Esta llamada falla con IllegalStateException si se produce un error interno del servicio. que encuentran.
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 objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. 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 a un subproceso adecuado.

receiver OutcomeReceiver: Este valor no puede ser null.