Menedżer odbiorców niestandardowych

public class CustomAudienceManager
extends Object

java.lang.Object
↳	android.adservices.customaudience.CustomAudienceManager

CustomAudienceManager udostępnia interfejsy API dla aplikacji i pakietów SDK reklam, które umożliwiają dołączanie do niestandardowych list odbiorców lub opuszczanie takich list.

Podsumowanie

Metody publiczne
`void`	`fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Dodaje użytkownika do pola `CustomAudience` pobranego z `fetchUri`.
`static CustomAudienceManager`	`get(Context context)` Fabryczna metoda tworzenia instancji CustomAudienceManager.
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` Tworzenie usługi z interfejsami API do włączania testów
`void`	`joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Dodaje użytkownika do właściwości `CustomAudience`.
`void`	`leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Próba usunięcia użytkownika z niestandardowej listy odbiorców przez usunięcie wszystkich istniejących danych `CustomAudience` identyfikowanych przez tagi `ownerPackageName`, `buyer` i `name`.

Metody dziedziczone

Z zajęć


        
          java.lang.Object

`Object`	`clone()` Tworzy i zwraca kopię tego obiektu.
`boolean`	`equals(Object obj)` Wskazuje, czy inny obiekt ma stan „równa się” tego.
`void`	`finalize()` Wywoływane przez funkcję czyszczenia pamięci obiektu podczas czyszczenia pamięci oznacza, że nie ma więcej odwołań do obiektu.
`final Class<?>`	`getClass()` Zwraca klasę środowiska wykonawczego tego zasobu (`Object`).
`int`	`hashCode()` Zwraca wartość kodu skrótu obiektu.
`final void`	`notify()` Wybudza pojedynczy wątek oczekujący na obiekt monitorowania.
`final void`	`notifyAll()` Wybudza wszystkie wątki oczekujące na monitorze tego obiektu.
`String`	`toString()` Zwraca obiekt w postaci ciągu znaków.
`final void`	`wait(long timeoutMillis, int nanos)` Powoduje, że bieżący wątek czeka, aż zostanie przebudzony. Zwykle przez powiadomienie lub przerwienie; upłynęło pewną ilość czasu.
`final void`	`wait(long timeoutMillis)` Powoduje, że bieżący wątek czeka, aż zostanie przebudzony. Zwykle przez powiadomienie lub przerwienie; upłynęło pewną ilość czasu.
`final void`	`wait()` Powoduje, że bieżący wątek czeka, aż zostanie przebudzony. Zwykle przez powiadomienie lub przerwienie;

Metody publiczne

downloadAndJoinCustomAudience

Dodano w przypadku Androida UpsideDownCakePrivacySandbox

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Dodaje użytkownika do pola CustomAudience pobranego z fetchUri.

Próba zarejestrowania użytkownika na liście odbiorców niestandardowych z tą samą kombinacją parametrów ownerPackageName, buyer i name spowoduje, że w przypadku istniejącej listy odbiorców niestandardowych informacje do zastąpienia, w tym listę danych reklam.

Pamiętaj, że listę reklam można całkowicie zastąpić przez codzienne zadanie pobierania danych w tle.

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

aplikacja wywołująca przekroczyła limit miejsca na dane lub
wszystkie parametry URI w podanym CustomAudience nie są uwierzytelnione za pomocą CustomAudience kupujący.

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
`fetchAndJoinCustomAudienceRequest`	`FetchAndJoinCustomAudienceRequest`: 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`.

odbierz

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 6

public static CustomAudienceManager get (Context context)

Fabryczna metoda tworzenia instancji CustomAudienceManager.

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

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

getTestCustomAudienceManager

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

Tworzenie usługi z interfejsami API do włączania testów

Zwroty
`TestCustomAudienceManager`	Ta wartość nie może być typu `null`.

JoinCustomAudience

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Dodaje użytkownika do właściwości CustomAudience.

Pamiętaj, że listę reklam można całkowicie zastąpić przez codzienne zadanie pobierania danych w tle.

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

aplikacja wywołująca przekroczyła limit miejsca na dane lub
wszystkie parametry URI w podanym CustomAudience nie są uwierzytelnione za pomocą CustomAudience kupujący.

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

Parametry
`joinCustomAudienceRequest`	`JoinCustomAudienceRequest`: 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`.

OpuśćNiestandardowe Odbiorcy

Dodano w interfejsie API na poziomie 34
Również w rozszerzeniach usług reklamowych 4

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Próba usunięcia użytkownika z niestandardowej listy odbiorców przez usunięcie wszystkich istniejących danych CustomAudience identyfikowanych przez tagi ownerPackageName, buyer i name.

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 wywołanie nie powiedzie się. LimitExceededException, jeśli pakiet przekraczający i ograniczane.

To wywołanie nie informuje wywołującego, czy istniała określona grupa odbiorców niestandardowych pamięci urządzenia. Inaczej mówiąc, odpada ona dyskretnie, gdy kupujący próbuje opuścić grupę niestandardowych odbiorców, którzy do niej nie dołączyli.
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parametry
`leaveCustomAudienceRequest`	`LeaveCustomAudienceRequest`: 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`.