CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Object (link em inglês)
↳	android.adservices.customaudience.CustomAudienceManager

O CustomAudienceManager fornece APIs para SDKs de anúncios e apps para fazer parte ou sair de públicos-alvo personalizados.

Resumo

Métodos públicos
`void`	`fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Adiciona o usuário ao `CustomAudience` buscado por um `fetchUri`.
`static CustomAudienceManager`	`get(Context context)` Método Factory para criar uma instância de CustomAudienceManager.
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` Criar um serviço com APIs de ativação de teste
`void`	`joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Adiciona o usuário ao `CustomAudience` especificado.
`void`	`leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` Tenta remover um usuário de um público-alvo personalizado excluindo os dados de `CustomAudience`, identificados por `ownerPackageName`, `buyer` e `name`.

Métodos herdados

Da classe


        
          java.lang.Object

`Object`	`clone()` Cria e retorna uma cópia desse objeto.
`boolean`	`equals(Object obj)` Indica se algum outro objeto é "igual a" esse.
`void`	`finalize()` Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.
`final Class<?>`	`getClass()` Retorna a classe de execução desse `Object`.
`int`	`hashCode()` Retorna um valor de código hash para o objeto.
`final void`	`notify()` Ativa uma única linha de execução que está em espera no monitor desse objeto.
`final void`	`notifyAll()` Ativa todos os threads que estão aguardando no monitor desse objeto.
`String`	`toString()` Retorna uma representação em string do objeto.
`final void`	`wait(long timeoutMillis, int nanos)` Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.
`final void`	`wait(long timeoutMillis)` Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.
`final void`	`wait()` Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida.

Métodos públicos

FetchAndJoinCustomAudience

Adicionado no Android UpsideDownCakePrivacySandbox

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

Adiciona o usuário ao CustomAudience buscado por um fetchUri.

Uma tentativa de registrar o usuário em um público-alvo personalizado com a mesma combinação de ownerPackageName, buyer e name vai fazer com que as informações do público-alvo personalizado sejam substituídas, incluindo a lista de dados de anúncios.

A lista de anúncios pode ser completamente substituída pelo trabalho de busca diária em segundo plano.

A chamada vai falhar com um SecurityException se

o ownerPackageName não estiver chamando o nome do pacote do app e/ou
o comprador não está autorizado a usar a API.

A chamada vai falhar com um IllegalArgumentException se

o limite de armazenamento foi excedido pelo aplicativo de chamada e/ou
Todos os parâmetros de URI no CustomAudience fornecidos não são autenticados com o comprador CustomAudience.

Essa chamada vai falhar com LimitExceededException se o pacote de chamada exceder os limites de taxa permitidos e for limitado.

Essa chamada vai falhar com um IllegalStateException se um erro interno de serviço for encontrado.
Requer AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parâmetros
`fetchAndJoinCustomAudienceRequest`	`FetchAndJoinCustomAudienceRequest`: este valor não pode ser `null`.
`executor`	`Executor`: este valor não pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `Context.getMainExecutor()`. Caso contrário, forneça um `Executor` que seja enviado para uma linha de execução adequada.
`receiver`	`OutcomeReceiver`: este valor não pode ser `null`.

get

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 6

public static CustomAudienceManager get (Context context)

Método Factory para criar uma instância de CustomAudienceManager.

Parâmetros
`context`	`Context`: o `Context` a ser usado. Esse valor não pode ser `null`.

Returns
`CustomAudienceManager`	Uma instância `CustomAudienceManager` Esse valor não pode ser `null`.

getTestCustomAudienceManager

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

Criar um serviço com APIs de ativação de teste

Returns
`TestCustomAudienceManager`	Esse valor não pode ser `null`.

joinCustomAudience

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

Adiciona o usuário ao CustomAudience especificado.

A lista de anúncios pode ser completamente substituída pelo trabalho de busca diária em segundo plano.

A chamada vai falhar com um SecurityException se

o ownerPackageName não estiver chamando o nome do pacote do app e/ou
o comprador não está autorizado a usar a API.

A chamada vai falhar com um IllegalArgumentException se

o limite de armazenamento foi excedido pelo aplicativo de chamada e/ou
Todos os parâmetros de URI no CustomAudience fornecidos não são autenticados com o comprador CustomAudience.

Essa chamada vai falhar com LimitExceededException se o pacote de chamada exceder os limites de taxa permitidos e for limitado.

Essa chamada vai falhar com um IllegalStateException se um erro interno de serviço for encontrado.
Requer AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parâmetros
`joinCustomAudienceRequest`	`JoinCustomAudienceRequest`: este valor não pode ser `null`.
`executor`	`Executor`: este valor não pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `Context.getMainExecutor()`. Caso contrário, forneça um `Executor` que seja enviado para uma linha de execução adequada.
`receiver`	`OutcomeReceiver`: este valor não pode ser `null`.

saiCustomAudience

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

Tenta remover um usuário de um público-alvo personalizado excluindo os dados de CustomAudience, identificados por ownerPackageName, buyer e name.

A chamada vai falhar com um SecurityException se

o ownerPackageName não estiver chamando o nome do pacote do app; e/ou
o comprador não está autorizado a usar a API.

Essa chamada vai falhar com LimitExceededException se o pacote de chamada exceder os limites de taxa permitidos e for limitado.

Essa chamada não informa ao autor da chamada se o público-alvo personalizado especificado existia no armazenamento do dispositivo. Em outras palavras, ocorrerá uma falha silenciosa quando um comprador tentar sair de um público-alvo personalizado que não foi associado.
Requer AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parâmetros
`leaveCustomAudienceRequest`	`LeaveCustomAudienceRequest`: este valor não pode ser `null`.
`executor`	`Executor`: este valor não pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `Context.getMainExecutor()`. Caso contrário, forneça um `Executor` que seja enviado para uma linha de execução adequada.
`receiver`	`OutcomeReceiver`: este valor não pode ser `null`.