ProtectedSignalsManager.UpdateSignals Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
L'API updateSignals recupererà un codice JSON dall'URI che descrive i segnali da aggiungere o rimuovere.
[Android.Runtime.Register("updateSignals", "(Landroid/adservices/signals/UpdateSignalsRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetUpdateSignals_Landroid_adservices_signals_UpdateSignalsRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_ADSERVICES_PROTECTED_SIGNALS")]
public virtual void UpdateSignals(Android.AdServices.Signals.UpdateSignalsRequest updateSignalsRequest, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("updateSignals", "(Landroid/adservices/signals/UpdateSignalsRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetUpdateSignals_Landroid_adservices_signals_UpdateSignalsRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_ADSERVICES_PROTECTED_SIGNALS")>]
abstract member UpdateSignals : Android.AdServices.Signals.UpdateSignalsRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.UpdateSignals : Android.AdServices.Signals.UpdateSignalsRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
Parametri
- updateSignalsRequest
- UpdateSignalsRequest
Richiesta che identifica l'URI da cui recuperare gli aggiornamenti del segnale. Questo valore non può essere null.
- executor
- IExecutor
Executor tramite cui vengono inviati gli eventi di callback. Questo valore non può essere null.
- receiver
- IOutcomeReceiver
Ricevitore chiamato con un oggetto vuoto in caso di esito positivo o eccezione in caso di errore. Questo valore non può essere null.
- Attributi
Commenti
L'API UpdateSignals recupererà un codice JSON dall'URI che descrive i segnali da aggiungere o rimuovere. Questa API consente anche di registrare l'endpoint del codificatore. L'endpoint viene usato per scaricare una logica di codifica, che consente la codifica dei segnali.
Le chiavi di primo livello per JSON devono corrispondere a uno dei 5 comandi seguenti:
"put" - Aggiunge un nuovo segnale, sovrascrivendo eventuali segnali esistenti con la stessa chiave. Il valore di questo è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave da inserire e i valori sono stringa base 64 corrispondente al valore da inserire.
"append" - Aggiunge un nuovo segnale/segnali a una serie temporale di segnali, rimuovendo i segnali meno recenti per liberare spazio per i nuovi segnali se le dimensioni della serie superano il valore massimo specificato. Il valore di questo è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave a cui accodare e i valori sono oggetti con due campi: "values" e "maxSignals". "values" è un elenco di stringhe base 64 corrispondenti ai valori dei segnali da aggiungere alla serie temporale. "maxSignals" è il numero massimo di valori consentiti in questo intervallo di tempo. Se il numero corrente di segnali associati alla chiave supera maxSignals i segnali meno recenti verranno rimossi. Si noti che è possibile aggiungere a una chiave aggiunta da put. Non che l'aggiunta di più del numero massimo di valori provocherà un errore.
"put_if_not_present" - Aggiunge un nuovo segnale solo se non sono presenti segnali esistenti con la stessa chiave. Il valore di questo è un oggetto JSON in cui le chiavi sono stringhe base 64 corrispondenti alla chiave da inserire e i valori sono stringa base 64 corrispondente al valore da inserire.
"remove" - Rimuove il segnale per una chiave. Il valore di questo è un elenco di stringhe di base 64 corrispondenti alle chiavi dei segnali che devono essere eliminati.
"update_encoder" : fornisce un'azione per aggiornare l'endpoint e un URI che può essere usato per recuperare una logica di codifica. La sottochiave per fornire un'azione di aggiornamento è "azione" e i valori attualmente supportati sono:
<ol><li>"REGISTER": registra l'endpoint del codificatore se specificato per la prima volta o sovrascrive quello esistente con l'endpoint appena fornito. L'opzione "endpoint" è necessaria per l'azione "REGISTER". </ol>
La sottochiave per fornire un endpoint del codificatore è "endpoint" e il valore è la stringa URI per l'endpoint.
In caso di esito positivo, il metodo onResult dell'oggetto OutcomeReceiver specificato verrà chiamato con un oggetto vuoto. Questo oggetto non ha alcun significato e viene utilizzato semplicemente come segnaposto.
La chiave può essere gestita solo da un comando per JSON. Se due comandi tentano di operare sulla stessa chiave, questo metodo eseguirà un IllegalArgumentException
Questa chiamata ha esito negativo con un valore SecurityException if
<ol><li>non chiama il ownerPackageName nome del pacchetto dell'app e/o <li>l'acquirente non è autorizzato a usare l'API.
</ol>
Questa chiamata ha esito negativo con un valore IllegalArgumentException if
<ol><li>Il codice JSON recuperato dal server non è valido. <li>L'URI fornito non è valido. </ol>
Questa chiamata ha esito negativo se LimitExceededException il pacchetto chiamante supera i limiti di frequenza consentiti e viene limitata.
Questa chiamata ha esito negativo e viene visualizzato un IllegalStateException errore interno del servizio.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.