CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Объект
↳	android.adservices.customaudience.CustomAudienceManager

CustomAudienceManager предоставляет API-интерфейсы для приложений и рекламных SDK, позволяющие присоединяться к пользовательским аудиториям и покидать их.

Краткое содержание

Публичные методы
`void`	`fetchAndJoinCustomAudience ( FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)` Добавляет пользователя в `CustomAudience` , полученный из `fetchUri` .
`static CustomAudienceManager`	`get ( Context context)` Фабричный метод для создания экземпляра CustomAudienceManager.
`TestCustomAudienceManager`	`getTestCustomAudienceManager ()` Создайте сервис с API-интерфейсами, поддерживающими тестирование.
`void`	`joinCustomAudience ( JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)` Добавляет пользователя в заданный `CustomAudience` .
`void`	`leaveCustomAudience ( LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)` Пытается удалить пользователя из пользовательской аудитории, удалив все существующие данные `CustomAudience` , идентифицированные по значениям `ownerPackageName` , `buyer` и `name` .

Унаследованные методы

Из класса java.lang.Object

`Object`	`clone ()` Создает и возвращает копию этого объекта.
`boolean`	`equals ( Object obj)` Указывает, «равен» ли какой-либо другой объект этому объекту.
`void`	`finalize ()` Вызывается сборщиком мусора для объекта, когда сборщик мусора определяет, что ссылок на объект больше нет.
`final Class <?>`	`getClass ()` Возвращает класс времени выполнения этого `Object` .
`int`	`hashCode ()` Возвращает значение хеш-кода для объекта.
`final void`	`notify ()` Пробуждает одиночный поток, ожидающий монитора этого объекта.
`final void`	`notifyAll ()` Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString ()` Возвращает строковое представление объекта.
`final void`	`wait (long timeoutMillis, int nanos)` Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.
`final void`	`wait (long timeoutMillis)` Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.
`final void`	`wait ()` Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания .

Публичные методы

fetchAndJoinCustomAudience

Добавлено в Android UpsideDownCakePrivacySandbox.

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

Добавляет пользователя в CustomAudience , полученный из fetchUri .

Попытка зарегистрировать пользователя для пользовательской аудитории с той же комбинацией ownerPackageName , buyer и name приведет к перезаписи существующей информации о пользовательской аудитории, включая список данных рекламы.

Обратите внимание, что список объявлений может быть полностью перезаписан при ежедневной фоновой выборке.

Этот вызов завершается с ошибкой SecurityException , если

ownerPackageName не вызывает имя пакета приложения и/или
покупатель не имеет права использовать API.

Этот вызов завершается с ошибкой IllegalArgumentException , если

лимит хранилища превышен вызывающим приложением и/или
любые параметры URI в указанном CustomAudience не аутентифицируются покупателем CustomAudience .

Этот вызов завершается с ошибкой LimitExceededException если вызывающий пакет превышает допустимые пределы скорости и регулируется.

Этот вызов завершается с ошибкой IllegalStateException , если возникает внутренняя ошибка службы.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE .

Параметры
`fetchAndJoinCustomAudienceRequest`	`FetchAndJoinCustomAudienceRequest` : это значение не может быть `null` .
`executor`	`Executor` : Это значение не может быть `null` . События обратного вызова и прослушивателя отправляются через этот `Executor` , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать `Context.getMainExecutor()` . В противном случае предоставьте `Executor` , который отправляет данные в соответствующий поток.
`receiver`	`OutcomeReceiver` : это значение не может быть `null` .

получать

Добавлено на уровне API 34.
Также в расширениях рекламных служб 6.

public static CustomAudienceManager get (Context context)

Фабричный метод для создания экземпляра CustomAudienceManager.

Параметры
`context`	`Context` : используемый `Context` . Это значение не может быть `null` .

Возврат
`CustomAudienceManager`	Экземпляр `CustomAudienceManager` . Это значение не может быть `null` .

getTestCustomAudienceManager

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public TestCustomAudienceManager getTestCustomAudienceManager ()

Создайте сервис с API-интерфейсами, поддерживающими тестирование.

Возврат
`TestCustomAudienceManager`	Это значение не может быть `null` .

присоединиться к пользовательской аудитории

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

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

Добавляет пользователя в заданный CustomAudience .

Обратите внимание, что список объявлений может быть полностью перезаписан в ходе ежедневной фоновой выборки.

Этот вызов завершается с ошибкой SecurityException , если

ownerPackageName не вызывает имя пакета приложения и/или
покупатель не имеет права использовать API.

Этот вызов завершается с ошибкой IllegalArgumentException , если

лимит хранилища превышен вызывающим приложением и/или
любые параметры URI в указанном CustomAudience не аутентифицируются покупателем CustomAudience .

Параметры
`joinCustomAudienceRequest`	`JoinCustomAudienceRequest` : это значение не может быть `null` .
`executor`	`Executor` : Это значение не может быть `null` . События обратного вызова и прослушивателя отправляются через этот `Executor` , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать `Context.getMainExecutor()` . В противном случае предоставьте `Executor` , который отправляет данные в соответствующий поток.
`receiver`	`OutcomeReceiver` : это значение не может быть `null` .

оставитьПользовательскаяАудитория

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

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

Пытается удалить пользователя из пользовательской аудитории, удалив все существующие данные CustomAudience , идентифицированные по значениям ownerPackageName , buyer и name .

Этот вызов завершается с ошибкой SecurityException , если

ownerPackageName не вызывает имя пакета приложения; и/или
покупатель не имеет права использовать API.

Этот вызов не сообщает вызывающему абоненту, существует ли указанная специально настроенная аудитория в хранилище на устройстве. Другими словами, он автоматически потерпит неудачу, когда покупатель попытается покинуть пользовательскую аудиторию, к которой он еще не присоединился.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE .

Параметры
`leaveCustomAudienceRequest`	`LeaveCustomAudienceRequest` : это значение не может быть `null` .
`executor`	`Executor` : Это значение не может быть `null` . События обратного вызова и прослушивателя отправляются через этот `Executor` , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать `Context.getMainExecutor()` . В противном случае предоставьте `Executor` , который отправляет данные в соответствующий поток.
`receiver`	`OutcomeReceiver` : это значение не может быть `null` .