Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4

Tóm tắt: Phương thức | Phương thức kế thừa

Trình quản lý đối tượng tuỳ chỉnh

public class CustomAudienceManager
extends Object

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

---

CustomAudienceManager cung cấp các API cho ứng dụng và SDK quảng cáo để giúp bạn tham gia hoặc rời khỏi đối tượng tùy chỉnh.

Tóm tắt

Phương thức công khai
void	fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Thêm người dùng vào CustomAudience được tìm nạp qua fetchUri.
static CustomAudienceManager	get(Context context) Phương thức ban đầu để tạo một thực thể của CustomAudienceManager.
TestCustomAudienceManager	getTestCustomAudienceManager() Tạo một dịch vụ có API bật thử nghiệm
void	joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Thêm người dùng vào CustomAudience đã cho.
void	leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Cố gắng xoá người dùng khỏi đối tượng tuỳ chỉnh bằng cách xoá mọi dữ liệu CustomAudience hiện có, được xác định theo ownerPackageName, buyer và name.

Các phương thức kế thừa

Trong lớp java.lang.Object Object clone() Tạo và trả về một bản sao của đối tượng này. boolean equals(Object obj) Cho biết liệu một đối tượng nào đó khác có "bằng" đối tượng này hay không. void finalize() Được trình thu gom rác gọi trên một đối tượng khi tính năng thu thập rác xác định rằng không có tham chiếu nào khác đến đối tượng. final Class<?> getClass() Trả về lớp thời gian chạy của Object này. int hashCode() Trả về một giá trị mã băm cho đối tượng. final void notify() Đánh thức một luồng duy nhất đang chờ trên màn hình của đối tượng này. final void notifyAll() Đánh thức tất cả các luồng đang chờ trên màn hình của đối tượng này. String toString() Trả về một chuỗi đại diện của đối tượng. final void wait(long timeoutMillis, int nanos) Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua. final void wait(long timeoutMillis) Yêu cầu luồng hiện tại đợi cho đến khi được đánh thức (thường là khi có thông báo hoặc bị gián đoạn) hoặc cho đến khi một khoảng thời gian thực nhất định đã trôi qua. final void wait() Yêu cầu luồng hiện tại phải đợi cho đến khi được đánh thức, thường là khi có thông báo hoặc bị gián đoạn.

Phương thức công khai

Tìm nạp vàTham giaTùy chỉnhĐối tượng

Đã thêm vào UpsideDownCakePrivacySandbox của Android

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

Thêm người dùng vào CustomAudience được tìm nạp qua fetchUri.

Việc cố đăng ký người dùng cho một đối tượng tuỳ chỉnh với cùng tổ hợp ownerPackageName, buyer và name sẽ khiến đối tượng tuỳ chỉnh hiện tại bị ghi đè, bao gồm cả danh sách dữ liệu quảng cáo.

Lưu ý rằng công việc tìm nạp ở chế độ nền hằng ngày có thể ghi đè hoàn toàn danh sách quảng cáo.

Cuộc gọi này không thực hiện được với SecurityException nếu

1. ownerPackageName không gọi tên gói và/hoặc của ứng dụng
2. người mua không được phép sử dụng API.

Cuộc gọi này không thực hiện được với IllegalArgumentException nếu

1. ứng dụng gọi và/hoặc đã vượt quá hạn mức bộ nhớ
2. mọi tham số URI trong CustomAudience đã cung cấp sẽ không được xác thực bằng Người mua thuộc CustomAudience.

Lệnh gọi này không thực hiện được với LimitExceededException nếu gói gọi vượt quá giới hạn số lượng yêu cầu và được điều tiết.

Lệnh gọi này không thực hiện được với IllegalStateException nếu lỗi dịch vụ nội bộ là gặp phải.
Cần có AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Tham số
fetchAndJoinCustomAudienceRequest	FetchAndJoinCustomAudienceRequest: Giá trị này không được là null.
executor	Executor: Giá trị này không được là null. Các sự kiện gọi lại và trình nghe được gửi thông qua Executor, giúp bạn dễ dàng kiểm soát luồng nào đã sử dụng. Để gửi sự kiện thông qua chuỗi chính của ứng dụng, bạn có thể sử dụng Context.getMainExecutor(). Nếu không, hãy cung cấp Executor để gửi đến một luồng phù hợp.
receiver	OutcomeReceiver: Giá trị này không được là null.

get

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 6

public static CustomAudienceManager get (Context context)

Phương thức ban đầu để tạo một thực thể của CustomAudienceManager.

Tham số
context	Context: Context để sử dụng Giá trị này không được là null.

Giá trị trả về
CustomAudienceManager	Một thực thể CustomAudienceManager Giá trị này không được là null.

getTestCustomAudienceManager

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

Tạo một dịch vụ có API bật thử nghiệm

Giá trị trả về
TestCustomAudienceManager	Giá trị này không được là null.

JoinCustomAudience (Đối tượng tham gia tuỳ chỉnh)

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4

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

Thêm người dùng vào CustomAudience đã cho.

Việc cố đăng ký người dùng cho một đối tượng tuỳ chỉnh với cùng tổ hợp ownerPackageName, buyer và name sẽ khiến đối tượng tuỳ chỉnh hiện tại bị ghi đè, bao gồm cả danh sách dữ liệu quảng cáo.

Lưu ý rằng công việc tìm nạp ở chế độ nền hằng ngày có thể ghi đè hoàn toàn danh sách quảng cáo.

Cuộc gọi này không thực hiện được với SecurityException nếu

1. ownerPackageName không gọi tên gói và/hoặc của ứng dụng
2. người mua không được phép sử dụng API.

Cuộc gọi này không thực hiện được với IllegalArgumentException nếu

1. ứng dụng gọi và/hoặc đã vượt quá hạn mức bộ nhớ
2. mọi tham số URI trong CustomAudience đã cung cấp sẽ không được xác thực bằng Người mua thuộc CustomAudience.

Lệnh gọi này không thực hiện được với LimitExceededException nếu gói gọi vượt quá giới hạn số lượng yêu cầu và được điều tiết.

Lệnh gọi này không thực hiện được với IllegalStateException nếu lỗi dịch vụ nội bộ là gặp phải.
Cần có AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Tham số
joinCustomAudienceRequest	JoinCustomAudienceRequest: Giá trị này không được là null.
executor	Executor: Giá trị này không được là null. Các sự kiện gọi lại và trình nghe được gửi thông qua Executor, giúp bạn dễ dàng kiểm soát luồng nào đã sử dụng. Để gửi sự kiện thông qua chuỗi chính của ứng dụng, bạn có thể sử dụng Context.getMainExecutor(). Nếu không, hãy cung cấp Executor để gửi đến một luồng phù hợp.
receiver	OutcomeReceiver: Giá trị này không được là null.

Để lại Đối tượng tuỳ chỉnh

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4

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

Cố gắng xoá người dùng khỏi đối tượng tuỳ chỉnh bằng cách xoá mọi dữ liệu CustomAudience hiện có, được xác định theo ownerPackageName, buyer và name.

Cuộc gọi này không thực hiện được với SecurityException nếu

1. ownerPackageName không gọi tên gói của ứng dụng; và/hoặc
2. người mua không được phép sử dụng API.

Lệnh gọi này không thực hiện được với LimitExceededException nếu gói gọi vượt quá giới hạn số lượng yêu cầu và được điều tiết.

Lệnh gọi này không thông báo cho phương thức gọi liệu đối tượng tuỳ chỉnh được chỉ định có tồn tại trong bộ nhớ trên thiết bị. Nói cách khác, chiến dịch sẽ tự động không thành công khi người mua cố gắng rời khỏi đối tượng tuỳ chỉnh chưa được tham gia.
Cần có AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Tham số
leaveCustomAudienceRequest	LeaveCustomAudienceRequest: Giá trị này không được là null.
executor	Executor: Giá trị này không được là null. Các sự kiện gọi lại và trình nghe được gửi thông qua Executor, giúp bạn dễ dàng kiểm soát luồng nào đã sử dụng. Để gửi sự kiện thông qua chuỗi chính của ứng dụng, bạn có thể sử dụng Context.getMainExecutor(). Nếu không, hãy cung cấp Executor để gửi đến một luồng phù hợp.
receiver	OutcomeReceiver: Giá trị này không được là null.