ProtectedSignalsManager
public
class
ProtectedSignalsManager
extends Object
java.lang.Object | |
😎 | android.adservices.signals.ProtectedSignalsManager |
ProtectedSignalsManager bietet APIs für Apps und Anzeigen-SDKs, um geschützte Signale zu verwalten.
Zusammenfassung
Öffentliche Methoden | |
---|---|
static
ProtectedSignalsManager
|
get(Context context)
Factory-Methode zum Erstellen einer Instanz von ProtectedSignalsManager. |
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. |
Übernommene Methoden | |
---|---|
Öffentliche Methoden
get
public static ProtectedSignalsManager get (Context context)
Factory-Methode zum Erstellen einer Instanz von ProtectedSignalsManager.
Parameter | |
---|---|
context |
Context : Der zu verwendende Context
Dieser Wert darf nicht null sein. |
Returns | |
---|---|
ProtectedSignalsManager |
Eine ProtectedSignalsManager -Instanz
Dieser Wert darf nicht null sein. |
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:
- „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
ownerPackageName
ruft nicht den Paketnamen der App auf und/oder- Der Käufer ist nicht zur Nutzung der API berechtigt.
Dieser Aufruf schlägt mit IllegalArgumentException
fehl, wenn
- Die vom Server abgerufene JSON-Datei ist ungültig.
- 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
Parameter | |
---|---|
updateSignalsRequest |
UpdateSignalsRequest : Dieser Wert darf nicht null sein. |
executor |
Executor : Dieser Wert darf nicht null sein.
Callback- und Listener-Ereignisse werden über dieses
Mit Executor lässt sich ganz einfach steuern, welcher Thread
verwendet. Um Ereignisse über den Hauptthread Ihres
können Sie
Context.getMainExecutor()
Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet. |
receiver |
OutcomeReceiver : Dieser Wert darf nicht null sein. |