API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

요약: 메서드 | 상속된 메서드

맞춤 잠재고객 관리자

public class CustomAudienceManager
extends Object

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

---

CustomAudienceManager가 맞춤 잠재고객에 가입 또는 탈퇴하는 데 사용할 수 있는 API를 제공합니다.

요약

공개 메서드
void	fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) fetchUri에서 가져온 CustomAudience에 사용자를 추가합니다.
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) ownerPackageName, buyer, name로 식별된 기존 CustomAudience 데이터를 삭제하여 맞춤 잠재고객에서 사용자를 삭제하려고 시도합니다.

상속된 메서드

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() 일반적으로 알림을 받거나 중단되어 절전 모드에서 해제될 때까지 현재 스레드가 대기하도록 합니다.

공개 메서드

importAndJoinCustomAudience

Android UpsideDownCakePrivacySandbox에 추가됨

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

fetchUri에서 가져온 CustomAudience에 사용자를 추가합니다.

ownerPackageName, buyer, name의 조합이 동일한 맞춤 잠재고객에 사용자를 등록하려고 하면 기존 맞춤 잠재고객의 광고 데이터 목록을 포함하여 덮어쓸 정보.

광고 목록은 매일 백그라운드 가져오기 작업으로 완전히 덮어쓸 수 있습니다.

다음과 같은 경우 SecurityException와 함께 이 호출이 실패합니다.

1. ownerPackageName가 앱의 패키지 이름을 호출하지 않는 경우
2. 구매자에게 API를 사용할 권한이 없습니다.

다음과 같은 경우 IllegalArgumentException와 함께 이 호출이 실패합니다.

1. 호출하는 애플리케이션이 저장용량 한도를 초과했거나
2. 지정된 CustomAudience의 URI 매개변수가 구매자 CustomAudience명.

호출 패키지가 다음을 초과하면 LimitExceededException와 함께 호출이 실패합니다. 제한되고 제한됩니다

내부 서비스 오류가 다음과 같은 경우 이 호출이 IllegalStateException 오류와 함께 실패합니다. 발생할 수 있습니다
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
fetchAndJoinCustomAudienceRequest	FetchAndJoinCustomAudienceRequest: 이 값은 null일 수 없습니다.
executor	Executor: 이 값은 null일 수 없습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
receiver	OutcomeReceiver: 이 값은 null일 수 없습니다.

get

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일 수 없습니다.

joinCustomAudience

API 수준 34에 추가됨
광고 서비스 확장 프로그램 4에도 추가됨

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

지정된 CustomAudience에 사용자를 추가합니다.

ownerPackageName, buyer, name의 조합이 동일한 맞춤 잠재고객에 사용자를 등록하려고 하면 기존 맞춤 잠재고객의 광고 데이터 목록을 포함하여 덮어쓸 정보.

광고 목록은 매일 백그라운드 가져오기 작업으로 완전히 덮어쓸 수 있습니다.

다음과 같은 경우 SecurityException와 함께 이 호출이 실패합니다.

1. ownerPackageName가 앱의 패키지 이름을 호출하지 않는 경우
2. 구매자에게 API를 사용할 권한이 없습니다.

다음과 같은 경우 IllegalArgumentException와 함께 이 호출이 실패합니다.

1. 호출하는 애플리케이션이 저장용량 한도를 초과했거나
2. 지정된 CustomAudience의 URI 매개변수가 구매자 CustomAudience명.

호출 패키지가 다음을 초과하면 LimitExceededException와 함께 호출이 실패합니다. 제한되고 제한됩니다

내부 서비스 오류가 다음과 같은 경우 이 호출이 IllegalStateException 오류와 함께 실패합니다. 발생할 수 있습니다
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
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)

ownerPackageName, buyer, name로 식별된 기존 CustomAudience 데이터를 삭제하여 맞춤 잠재고객에서 사용자를 삭제하려고 시도합니다.

다음과 같은 경우 SecurityException와 함께 이 호출이 실패합니다.

1. ownerPackageName가 앱의 패키지 이름을 호출하지 않습니다. 및/또는
2. 구매자에게 API를 사용할 권한이 없습니다.

호출 패키지가 다음을 초과하면 LimitExceededException와 함께 호출이 실패합니다. 제한되고 제한됩니다

이 호출은 지정된 맞춤 잠재고객이 기기 내 저장소입니다. 즉, 구매자가 지정된 CPM을 지키지 않고 가입되지 않은 맞춤 잠재고객입니다.
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE 필요

매개변수
leaveCustomAudienceRequest	LeaveCustomAudienceRequest: 이 값은 null일 수 없습니다.
executor	Executor: 이 값은 null일 수 없습니다. 콜백과 리스너 이벤트는 다음을 통해 전달됩니다. Executor: 어떤 스레드를 실행할지 쉽게 제어할 수 있게 함 있습니다. 앱의 기본 스레드를 통해 이벤트를 애플리케이션의 Context.getMainExecutor() 그 외의 경우에는 적절한 스레드로 전달되는 Executor를 제공합니다.
receiver	OutcomeReceiver: 이 값은 null일 수 없습니다.