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<ObjectException> receiver)

L'API updateSignals recupererà un file JSON dall'URI che descrive quali indicatori aggiungere o rimuovere.

Metodi ereditati

Metodi pubblici

ricevi

public static ProtectedSignalsManager get (Context context)

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

Parametri
context Context: Context da usare Questo valore non può essere null.

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

updateSignals

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

L'API updateSignals recupererà un file JSON dall'URI che descrive quali indicatori aggiungere o rimuovere. Questa API consente anche di registrare l'endpoint del codificatore. L'endpoint viene utilizzato scarica una logica di codifica che consente la codifica dei segnali.

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

"metti" - Aggiunge un nuovo indicatore, sovrascrivendo quelli esistenti con la stessa chiave. Il valore questo è un oggetto JSON in cui le chiavi sono stringhe di base 64 corrispondenti alla chiave for e i valori sono una stringa in base 64 corrispondente al valore da inserire.

"aggiungere" - Aggiunta di nuovi segnali/indicatori a una serie temporale di indicatori, rimuovendo quelli meno recenti per fare spazio a quelli nuovi se le dimensioni della serie superano il limite massimo stabilito. Il valore è un oggetto JSON in cui le chiavi sono stringhe di base 64 corrispondenti chiave da aggiungere e i valori sono oggetti con due campi: "values" e "maxSignals" di Google. "valori" è un elenco di stringhe in base 64 corrispondenti ai valori dei segnali da aggiungere al tempo Google Cloud. "maxSignals" è il numero massimo di valori consentiti in questa serie temporale. Se il numero attuale di indicatori associati alla chiave supera maxSignals, quelli meno recenti verrà rimosso. Tieni presente che puoi aggiungere elementi a una chiave aggiunta tramite put. Non che aggiungere più di il numero massimo di valori causerà un errore.

"put_se_non_presenta" - Aggiunge un nuovo indicatore solo se non esistono indicatori con il valore la stessa chiave. Il valore è un oggetto JSON in cui le chiavi sono stringhe di base 64 corrispondente alla chiave da inserire e i valori sono una stringa in base 64 corrispondente alla il valore da inserire.

"rimuovi" - Rimuove il segnale per una chiave. Il valore è un elenco di stringhe in base 64 corrispondenti alle chiavi degli indicatori che devono essere eliminati.

"update_encoder" - Fornisce un'azione per aggiornare l'endpoint, nonché un URI che può essere utilizzato per recuperare una logica di codifica. La sottochiave per fornire un'azione di aggiornamento è "azione" e ai attualmente supportati sono:

  1. "REGISTRATI" : registra l'endpoint del codificatore se fornito per la prima volta o sovrascriverà quello esistente con l'endpoint appena fornito. Fornire l'"endpoint" è obbligatorio per "REGISTER" un'azione.

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

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

Questa chiamata non va a buon fine con un SecurityException se

  1. ownerPackageName non sta chiamando il nome del pacchetto dell'app e/o
  2. l'acquirente non è autorizzato a utilizzare l'API.

Questa chiamata non va a buon fine con un IllegalArgumentException se

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

Questa chiamata non va a buon fine con LimitExceededException se il pacchetto chiamante supera le consentiti, ed è limitato.

Questa chiamata non riesce e restituisce un errore IllegalStateException se si verifica un errore interno del servizio riscontrati.
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 consente di controllare facilmente quale thread in uso. Per inviare eventi tramite il thread principale del tuo 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.