CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Object
↳	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 em um `fetchUri`.
`static CustomAudienceManager`	`get(Context context)` Método de fábrica para criar uma instância de CustomAudienceManager.
`TestCustomAudienceManager`	`getTestCustomAudienceManager()` Criar um serviço com APIs de ativação de testes
`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` existentes, 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 UpsideDownCakePrivacySandbox do Android

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

Adiciona o usuário ao CustomAudience buscado em 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 o comportamento informações a serem 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.

Esta chamada vai falhar com um SecurityException se

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

Esta chamada vai falhar com um IllegalArgumentException se

o limite de armazenamento for excedido pelo aplicativo de chamada e/ou
quaisquer parâmetros de URI no CustomAudience fornecidos não estão autenticados com a CustomAudience comprador.

Esta chamada falhará com LimitExceededException se o pacote de chamada exceder o os limites de taxa permitidos e é limitada.

Esta chamada vai falhar com um IllegalStateException se for um erro de serviço interno encontrados.
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 retorno de chamada e escuta são despachados através deste `Executor`, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar `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 publicidade 6

public static CustomAudienceManager get (Context context)

Método de fábrica para criar uma instância de CustomAudienceManager.

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

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

getTestCustomAudienceManager

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

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

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

joinCustomAudience

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 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.

Esta chamada vai falhar com um SecurityException se

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

Esta chamada vai falhar com um IllegalArgumentException se

o limite de armazenamento for excedido pelo aplicativo de chamada e/ou
quaisquer parâmetros de URI no CustomAudience fornecidos não estão autenticados com a CustomAudience comprador.

Esta chamada falhará com LimitExceededException se o pacote de chamada exceder o os limites de taxa permitidos e é limitada.

Esta chamada vai falhar com um IllegalStateException se for um erro de serviço interno encontrados.
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 retorno de chamada e escuta são despachados através deste `Executor`, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar `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`.

deixarCustomAudience

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 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 existentes, identificados por ownerPackageName, buyer e name.

Esta chamada vai falhar com um SecurityException se

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

Esta chamada falhará com LimitExceededException se o pacote de chamada exceder o os limites de taxa permitidos e é limitada.

Essa chamada não informa ao autor da chamada se o público-alvo personalizado especificado existia em o armazenamento no dispositivo. Em outras palavras, ele falhará silenciosamente quando um comprador tentar sair de uma público-alvo personalizado que não foi incluído.
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 retorno de chamada e escuta são despachados através deste `Executor`, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar `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`.