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<Object, Exception> 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<Object, Exception> 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:
- “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
ownerPackageName
no llama al nombre del paquete de la app.- el comprador no está autorizado a usar la API.
Esta llamada falla con un IllegalArgumentException
si
- El JSON recuperado del servidor no es válido.
- 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 . |