ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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

ProtectedSignalsManager fornisce API per app e SDK di annunci per la gestione degli indicatori protetti.

Riepilogo

Metodi pubblici
`static ProtectedSignalsManager`	`get(Context context)` Metodo di fabbrica per la creazione di un'istanza di ProtectedSignalsManager.
`void`	`updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` L'API updateSignals recupererà dall'URI un file JSON che descrive quali indicatori aggiungere o rimuovere.

Metodi ereditati

Dal corso


        
          java.lang.Object

`Object`	`clone()` Crea e restituisce una copia di questo oggetto.
`boolean`	`equals(Object obj)` Indica se un altro oggetto è "uguale" a questo.
`void`	`finalize()` Viene chiamato dal garbage collector su un oggetto quando la raccolta del garbage determina che non ci sono più riferimenti all'oggetto.
`final Class<?>`	`getClass()` Restituisce la classe di runtime di questo `Object`.
`int`	`hashCode()` Restituisce un valore del codice hash per l'oggetto.
`final void`	`notify()` Riattiva un singolo thread in attesa sul monitor di questo oggetto.
`final void`	`notifyAll()` Riattiva tutti i thread in attesa sul monitor di questo oggetto.
`String`	`toString()` Restituisce una rappresentazione di stringa dell'oggetto.
`final void`	`wait(long timeoutMillis, int nanos)` Fa in modo che il thread attuale attenda fino a quando non viene riattivato, in genere tramite notifica o interrotta, oppure fino al termine di un determinato periodo di tempo reale.
`final void`	`wait(long timeoutMillis)` Fa in modo che il thread attuale attenda fino a quando non viene riattivato, in genere tramite notifica o interrotta, oppure fino al termine di un determinato periodo di tempo reale.
`final void`	`wait()` Il thread corrente attende fino a quando non viene riattivato, in genere tramite notifica o interruzione.

Metodi pubblici

ricevi

Aggiunta in Android UpsideDownCakePrivacySandbox

public static ProtectedSignalsManager get (Context context)

Metodo di fabbrica per la creazione di un'istanza di ProtectedSignalsManager.

Parametri
`context`	`Context`: il `Context` da utilizzare Questo valore non può essere `null`.

Ritorni
`ProtectedSignalsManager`	Un'istanza di `ProtectedSignalsManager` Questo valore non può essere `null`.

updateSignals

Aggiunta in Android UpsideDownCakePrivacySandbox

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

L'API updateSignals recupera un JSON dall'URI che descrive quali indicatori aggiungere o rimuovere. Questa API consente anche di registrare l'endpoint dell'encoder. L'endpoint viene utilizzato per scaricare una logica di codifica che consente di codificare gli indicatori.

Le chiavi di primo livello per il JSON devono corrispondere a uno dei cinque comandi:

"put": aggiunge un nuovo indicatore, sovrascrivendo gli indicatori esistenti con la stessa chiave. Il valore corrispondente è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave per la quale eseguire il put e i valori sono stringhe base 64 corrispondenti al valore da inserire.

"append": aggiunge un nuovo segnale/indicatore a una serie temporale di indicatori, rimuovendo quelli meno recenti per fare spazio a quelli nuovi se le dimensioni della serie superano il valore massimo specificato. Il valore è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave da aggiungere e i valori sono oggetti con due campi: "values" e "maxSignals" . "values" è un elenco di stringhe base 64 corrispondenti ai valori dell'indicatore da aggiungere alla serie temporale. "maxSignals" è il numero massimo di valori consentiti in questa serie temporale. Se il numero attuale di indicatori associati alla chiave supera maxSignals, gli indicatori meno recenti verranno rimossi. Tieni presente che puoi aggiungere elementi a una chiave aggiunta con put. Tuttavia, l'aggiunta di più del numero massimo di valori causerà un errore.

"put_if_not_present": aggiunge un nuovo indicatore solo se non esistono indicatori con la stessa chiave. Il valore è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondente alla chiave per la quale eseguire l'operazione PUT e i valori sono stringhe base 64 corrispondenti al valore da inserire.

"remove": consente di rimuovere l'indicatore per una chiave. Il valore è un elenco di stringhe in base 64 corrispondenti alle chiavi degli indicatori che devono essere eliminate.

"update_encoder": fornisce un'azione per aggiornare l'endpoint e un URI che può essere utilizzato per recuperare una logica di codifica. La chiave secondaria per fornire un'azione di aggiornamento è "action" e i valori attualmente supportati sono:

"REGISTER" : registra l'endpoint dell'encoder se fornito per la prima volta o sovrascrive quello esistente con l'endpoint appena fornito. Fornire l'attributo "endpoint" è obbligatorio per l'azione "REGISTER".

La chiave secondaria per fornire un endpoint del codificatore è "endpoint" e il valore è la stringa URI per l'endpoint.

La chiave può essere utilizzata da un solo comando per JSON. Se due comandi tentano di eseguire operazioni sulla stessa chiave, questo metodo tramite un IllegalArgumentException

Questa chiamata non va a buon fine con un SecurityException se

ownerPackageName non chiama il nome del pacchetto dell'app e/o
L'acquirente non è autorizzato a utilizzare l'API.

Questa chiamata non va a buon fine con un IllegalArgumentException se

Il JSON recuperato dal server non è valido.
L'URI fornito non è valido.

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto di chiamate supera i limiti di frequenza consentiti ed è limitato.

Questa chiamata non va a buon fine e restituisce un errore IllegalStateException se si verifica un errore interno del servizio.
Richiede AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametri
`updateSignalsRequest`	`UpdateSignalsRequest`: questo valore non può essere `null`.
`executor`	`Executor`: questo valore non può essere `null`. Gli eventi di callback e listener vengono inviati tramite questo `Executor`, che offre un modo semplice per controllare il thread utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare `Context.getMainExecutor()`. In caso contrario, specifica un valore `Executor` che effettui l'invio a un thread appropriato.
`receiver`	`OutcomeReceiver`: questo valore non può essere `null`.