Trang này được dịch bởi Cloud Translation API.

Đã 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

ownerPackageName không gọi tên gói và/hoặc của ứng dụng
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

ứng dụng gọi và/hoặc đã vượt quá hạn mức bộ nhớ
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.

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

ownerPackageName không gọi tên gói và/hoặc của ứng dụng
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

ứng dụng gọi và/hoặc đã vượt quá hạn mức bộ nhớ
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

ownerPackageName không gọi tên gói của ứng dụng; và/hoặc
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`.