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<Object, Exception> 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<Object, Exception> 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:
- „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
ownerPackageName
nie wywołuje nazwy pakietu aplikacji lub- 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
- Plik JSON pobrany z serwera jest nieprawidłowy.
- 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 . |