ProtectedSignalsManager

get

public static ProtectedSignalsManager get (Context context)

Factory-Methode zum Erstellen einer Instanz von ProtectedSignalsManager.

updateSignals-Daten

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

Über die updateSignals API wird eine JSON-Datei aus dem URI abgerufen, in der beschrieben wird, welche Signale hinzugefügt werden sollen. oder entfernen. Mit dieser API ist auch die Registrierung des Encoder-Endpunkts möglich. Der Endpunkt wird verwendet, um eine Codierungslogik herunterladen, die die Codierung der Signale ermöglicht

Die Schlüssel der obersten Ebene für die JSON-Datei müssen einem der fünf Befehle entsprechen:

„put“ – Fügt ein neues Signal hinzu, das alle vorhandenen Signale mit demselben Schlüssel überschreibt. Der Wert ist ein JSON-Objekt, bei dem die Schlüssel Basis-64-Strings sind, die dem Schlüssel entsprechen, for und die Werte sind Basis-64-Strings, die dem auszugebenden Wert entsprechen.

„Anhängen“ - Fügt einer Zeitreihe von Signalen neue Signale hinzu und entfernt die ältesten. Signale, um Platz für neue zu schaffen, wenn die Größe der Reihen das angegebene Maximum überschreitet. Der Wert hierfür ist ein JSON-Objekt, bei dem die Schlüssel Basis-64-Strings sind, die dem Schlüssel, an den angehängt wird, und die Werte sind Objekte mit zwei Feldern: "values" und „maxSignals“ . „Werte“ ist eine Liste von Basis-64-Strings, die Signalwerten entsprechen, die an die Zeit angehängt werden sollen. . „maxSignals“ ist die maximale Anzahl der in dieser Zeitreihe zulässigen Werte. Wenn Die aktuelle Anzahl der mit dem Schlüssel verknüpften Signale überschreitet „maxSignals“ der ältesten Signale werden entfernt. Beachten Sie, dass Sie an einen Schlüssel anhängen können, der durch "put" hinzugefügt wurde. Nicht, dass das Anhängen von mehr als der maximalen Anzahl von Werten verursachen einen Fehler.

„put_if_not_present“ - Fügt nur dann ein neues Signal hinzu, wenn es keine vorhandenen Signale mit dem Parameter und denselben Schlüssel hat. Der Wert hierfür ist ein JSON-Objekt, bei dem die Schlüssel Basis-64-Strings sind. die dem Schlüssel entsprechen, für den sie abgelegt werden sollen, und die Werte sind Basis-64-Strings, die der festzulegenden Werts.

"entfernen" – Entfernt das Signal für einen Schlüssel. Der Wert hierfür ist eine Liste mit Basis-64-Strings. den Schlüsseln der zu löschenden Signale entsprechen.

„encoder aktualisieren“ - Bietet eine Aktion zum Aktualisieren des Endpunkts sowie einen URI, der verwendet werden kann. um eine Codierungslogik abzurufen. Der Unterschlüssel zum Angeben einer Aktualisierungsaktion ist „action“. und die Derzeit werden folgende Werte unterstützt:

1. „REGISTRIEREN“ : Registriert den Encoder-Endpunkt, falls er zum ersten Mal angegeben wird, oder überschreibt den vorhandenen mit dem neu angegebenen Endpunkt. Bereitstellung des "Endpunkts" ist für "REGISTER" erforderlich. Aktion ausführen.

Der Unterschlüssel zum Angeben eines Encoder-Endpunkts ist „endpoint“ und der Wert ist der URI, String für den Endpunkt.

Schlüssel darf nur mit einem Befehl pro JSON ausgeführt werden. Wenn zwei Befehle versuchen, denselben Schlüssel, wird bei dieser Methode ein IllegalArgumentException

Dieser Aufruf schlägt mit SecurityException fehl, wenn

1. ownerPackageName ruft nicht den Paketnamen der App auf und/oder
2. Der Käufer ist nicht zur Nutzung der API berechtigt.

Dieser Aufruf schlägt mit IllegalArgumentException fehl, wenn

1. Die vom Server abgerufene JSON-Datei ist ungültig.
2. Der angegebene URI ist ungültig.

Dieser Aufruf schlägt mit LimitExceededException fehl, wenn das aufrufende Paket die und wird gedrosselt.

Dieser Aufruf schlägt mit der Fehlermeldung IllegalStateException fehl, wenn ein interner Dienstfehler gefunden wurden.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE