ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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


ProtectedSignalsManager udostępnia interfejsy API dla aplikacji i pakietów SDK do wyświetlania reklam, które umożliwiają zarządzanie zabezpieczonymi sygnałami.

Podsumowanie

Metody publiczne

static ProtectedSignalsManager get(Context context)

Metoda fabryczna tworzenia instancji ProtectedSignalsManager.

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

Interfejs updateSignals API pobierze z identyfikatora URI kod JSON opisujący, które sygnały należy dodać lub usuń.

Metody dziedziczone

Metody publiczne

odbierz

public static ProtectedSignalsManager get (Context context)

Fabryczna metoda tworzenia instancji ProtectedSignalsManager.

Parametry
context Context: element Context, którego należy użyć Ta wartość nie może być null.

Zwroty
ProtectedSignalsManager Instancja ProtectedSignalsManager Ta wartość nie może być typu null.

zaktualizuj sygnały

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

Interfejs updateSignals API pobierze z identyfikatora URI kod JSON opisujący, które sygnały należy dodać lub usuń. Ten interfejs API umożliwia też zarejestrowanie punktu końcowego kodera. Punkt końcowy jest używany do pobrać kodowanie, które umożliwia kodowanie sygnałów.

Klucze najwyższego poziomu w formacie JSON muszą odpowiadać jednemu z 5 poleceń:

„put” – Dodaje nowy sygnał, zastępując wszystkie dotychczasowe sygnały tym samym kluczem. Wartość jest to obiekt JSON, w którym klucze są ciągami 64-osobowymi odpowiadającymi kluczowi, który ma zostać umieszczony for , a wartości są łańcuchem 64 podpisów odpowiadającym wartości do umieszczenia.

„append” - Dodaje nowy sygnał/sygnał do ciągu czasowego sygnałów i usuwa najstarsze aby zrobić miejsce na nowe, jeśli rozmiar serii przekracza podany limit. Wartość tego obiektu jest obiektem JSON, w którym klucze są ciągami w formacie 64 odpowiadającymi kluczowi klucz, do którego chcesz dołączyć, a wartości są obiektami z dwoma polami: „values” i „maxSignals” , „wartości” to lista ciągów znaków w formacie 64 odpowiadających wartościom sygnałów, które mają zostać dołączone do czasu serii. „maxSignals” to maksymalna dozwolona liczba wartości w tym ciągu czasowym. Jeśli bieżąca liczba sygnałów powiązanych z kluczem przekracza wartość maxSignals najstarszych sygnałów zostaną usunięte. Pamiętaj, że możesz dołączyć do klucza dodanego przez polecenie put. Nie tak, jeśli dodasz więcej niż maksymalna liczba wartości spowoduje błąd.

„put_if_not_present” – Dodaje nowy sygnał tylko wtedy, gdy nie ma istniejących sygnałów z parametrem ten sam klucz. Wartość tego obiektu jest obiektem JSON, w którym klucze są ciągami 64 podstawy. odpowiadające kluczowi, dla którego chcesz umieścić dane, a wartości są ciągiem 64 odpowiadającym kluczowi wartość do zastosowania.

„usuń” – usuwa sygnał z klucza. Wartością tego jest lista ciągów w formacie 64. odpowiadające kluczom sygnałów, które należy usunąć.

„update_encoder” – Udostępnia działanie aktualizacji punktu końcowego i identyfikator URI, którego można użyć aby pobrać logikę kodowania. Klucz podrzędny dotyczący działania aktualizacji to „action” oraz obecnie obsługiwane wartości to:

  1. „ZAREJESTRUJ SIĘ” : rejestruje punkt końcowy kodera, jeśli został podany po raz pierwszy lub zastępuje istniejący punkt końcowy nowo podanym punktem końcowym. Określanie „punktu końcowego” – pole „REGISTER” jest wymagane działania.

Podkluczem do określenia punktu końcowego kodera jest „punkt końcowy”. a wartością jest identyfikator URI ciągu znaków dla punktu końcowego.

Na kluczu można obsługiwać tylko 1 polecenie w pliku JSON. Jeśli 2 polecenia spróbują wykonać działanie na tego samego klucza, ta metoda przejdzie przez interfejs IllegalArgumentException

To połączenie zakończy się niepowodzeniem i zostanie wyświetlony komunikat SecurityException, jeśli

  1. ownerPackageName nie wywołuje nazwy pakietu aplikacji lub
  2. kupujący nie jest upoważniony do korzystania z interfejsu API,

To połączenie zakończy się niepowodzeniem i zostanie wyświetlony komunikat IllegalArgumentException, jeśli

  1. Plik JSON pobrany z serwera jest nieprawidłowy.
  2. Podany identyfikator URI jest nieprawidłowy.

To wywołanie nie powiedzie się. LimitExceededException, jeśli pakiet przekraczający i ograniczane.

To wywołanie kończy się niepowodzeniem i wyświetlany jest komunikat IllegalStateException, jeśli wewnętrzny błąd usługi to napotkano problem.
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametry
updateSignalsRequest UpdateSignalsRequest: ta wartość nie może być typu null.

executor Executor: ta wartość nie może być typu null. Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora Executor, co pozwala łatwo kontrolować, który wątek jest . Aby wysyłać zdarzenia przez wątek główny aplikacji, możesz użyć Context.getMainExecutor() W przeciwnym razie podaj Executor, który wysyła do odpowiedniego wątku.

receiver OutcomeReceiver: ta wartość nie może być typu null.