ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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

ProtectedSignalsManager fornisce API per app e SDK di annunci per gestire i loro 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à un JSON dall'URI che descrive quali indicatori aggiungere o rimuovere.

Metodi ereditati

Dal corso


        
          java.lang.Object

`Object`	`clone()` Crea e restituisce una copia dell'oggetto.
`boolean`	`equals(Object obj)` Indica se qualche altro oggetto è "uguale a" questo.
`void`	`finalize()` Richiamato dal garbage collector su un oggetto quando la garbage collection determina che non ci sono altri riferimenti all'oggetto.
`final Class<?>`	`getClass()` Restituisce la classe di runtime di `Object`.
`int`	`hashCode()` Restituisce un valore di 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 stringa dell'oggetto.
`final void`	`wait(long timeoutMillis, int nanos)` Fa sì che il thread corrente attenda finché non viene riattivato, in genere tramite notifica o interruzione, o fino a quando non è trascorso un determinato periodo di tempo reale.
`final void`	`wait(long timeoutMillis)` Fa sì che il thread corrente attenda finché non viene riattivato, in genere tramite notifica o interruzione, o fino a quando non è trascorso un determinato periodo di tempo reale.
`final void`	`wait()` Fa sì che il thread corrente attenda fino a quando non viene riattivato, in genere tramite una notifica o un'interruzione.

Metodi pubblici

ricevi

Aggiunta in UpsideDownCakePrivacySandbox per Android

public static ProtectedSignalsManager get (Context context)

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

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

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

updateSignals

Aggiunta in UpsideDownCakePrivacySandbox per Android

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

L'API updateSignals recupererà 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 la codifica dei segnali.

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

"put": aggiunge un nuovo indicatore, sovrascrivendo eventuali indicatori esistenti con la stessa chiave. Il valore di questo oggetto è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave da mettere e i valori sono stringhe base 64 corrispondenti al valore da mettere.

"append": aggiunge un nuovo segnale/indicatori a una serie temporale di indicatori, rimuovendo i segnali meno recenti per fare spazio a quelli nuovi se la dimensione della serie supera il limite massimo specificato. Il valore di questo oggetto è un oggetto JSON in cui le chiavi sono stringhe di base 64 corrispondenti alla chiave da aggiungere e i valori sono oggetti con due campi: "values" e "maxSignals" . "values" è un elenco di stringhe in base 64 che corrispondono ai valori degli indicatori 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 tramite put. Tieni presente che l'aggiunta di un numero superiore di valori al massimo comporta un errore.

"put_if_not_present": aggiunge un nuovo indicatore solo se non sono presenti indicatori con la stessa chiave. Il valore per questo oggetto è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave da inserire e i valori sono stringhe base 64 corrispondenti al valore da mettere.

"remove": rimuove il segnale per una chiave. Il valore è un elenco di stringhe di 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 sottochiave per fornire un'azione di aggiornamento è "action" e i valori attualmente supportati sono:

"REGISTER" : registra l'endpoint del codificatore se fornito per la prima volta oppure sovrascrive quello esistente con l'endpoint appena fornito. Per l'azione "REGISTER" è necessario fornire l'"endpoint".

La sottochiave per fornire un endpoint del codificatore è "endpoint" e il valore è la stringa URI dell'endpoint.

La chiave può essere utilizzata da un solo comando per JSON. Se due comandi tentano di operare sulla stessa chiave, questo metodo riceverà un comando 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 per le chiamate supera i limiti di frequenza consentiti ed è limitato.

Se si verifica un errore del servizio interno, questa chiamata non riesce con un codice IllegalStateException.
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 di listener vengono inviati tramite questo `Executor`, offrendo un modo semplice per controllare quale thread viene utilizzato. Per inviare eventi tramite il thread principale della tua applicazione, puoi utilizzare `Context.getMainExecutor()`. In caso contrario, specifica un `Executor` che verrà inviato al thread appropriato.
`receiver`	`OutcomeReceiver`: questo valore non può essere `null`.