ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

java.lang.Object
↳	android.adservices.signals.ProtectedSignalsManager

ProtectedSignalsManager cung cấp API cho các ứng dụng và SDK quảng cáo để quản lý tín hiệu được bảo vệ.

Tóm tắt

Phương thức công khai
`static ProtectedSignalsManager`	`get(Context context)` Phương thức nhà máy để tạo một thực thể của ProtectedSignalsManager.
`void`	`updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` API updateSignals sẽ truy xuất một tệp JSON từ URI mô tả tín hiệu cần thêm hoặc xoá.

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

get

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

public static ProtectedSignalsManager get (Context context)

Phương thức nhà máy để tạo một phiên bản của ProtectedSignalsManager.

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

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

updateSignals

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

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

API updateSignals sẽ truy xuất một tệp JSON từ URI mô tả tín hiệu cần thêm hoặc xoá. API này cũng cho phép đăng ký điểm cuối bộ mã hoá. Điểm cuối được dùng để tải xuống logic mã hoá để cho phép mã hoá các tín hiệu.

Các khoá cấp cao nhất cho JSON phải tương ứng với một trong 5 lệnh:

"put" – Thêm tín hiệu mới, ghi đè mọi tín hiệu hiện có bằng cùng một khoá. Giá trị cho đây là đối tượng JSON, trong đó các khoá là chuỗi cơ sở 64 tương ứng với khoá cần đặt for và các giá trị là chuỗi cơ số 64 tương ứng với giá trị cần đặt.

"nối" - Thêm một tín hiệu/các tín hiệu mới vào một chuỗi tín hiệu thời gian, xoá tín hiệu cũ nhất để tạo chỗ trống cho các tín hiệu mới nếu kích thước của chuỗi vượt quá mức tối đa đã cho. Giá trị cho tín hiệu này là đối tượng JSON, trong đó các khoá là chuỗi cơ sở 64 tương ứng với khóa để nối và giá trị là các đối tượng có hai trường: "values" và "maxSignals" của Google. "giá trị" là danh sách các chuỗi cơ sở 64 tương ứng với các giá trị tín hiệu cần thêm vào thời gian loạt phim. "maxSignals" là số lượng giá trị tối đa được phép trong chuỗi thời gian này. Nếu số lượng tín hiệu hiện tại được liên kết với khoá vượt quá maxSignals, tức là các tín hiệu cũ nhất sẽ bị xoá. Xin lưu ý rằng bạn có thể nối vào khoá được thêm bằng cách đặt. Không nối nhiều hơn số lượng giá trị tối đa sẽ gây ra lỗi.

"put_if_not_present" - Chỉ thêm tín hiệu mới khi không có tín hiệu nào với cùng một khoá. Giá trị cho tín hiệu này là một đối tượng JSON, trong đó khoá là các chuỗi cơ sở 64 tương ứng với khoá cần đặt và các giá trị là chuỗi cơ sở 64 tương ứng với giá trị cần đặt.

"xoá" – Xoá tín hiệu của một khoá. Giá trị của tín hiệu này là danh sách các chuỗi cơ sở 64 tương ứng với các khoá của tín hiệu cần xoá.

"update_encoder" – Cung cấp một thao tác để cập nhật điểm cuối và URI có thể dùng để truy xuất một logic mã hoá. Khoá phụ để cung cấp hành động cập nhật là "action" và các giá trị hiện được hỗ trợ là:

"ĐĂNG KÝ" : Đăng ký điểm cuối bộ mã hoá nếu được cung cấp lần đầu tiên hoặc sẽ ghi đè điểm cuối hiện có bằng điểm cuối mới được cung cấp. Cung cấp "điểm cuối" là yêu cầu bắt buộc cho lệnh "REGISTER" hành động.

Khoá phụ để cung cấp điểm cuối bộ mã hoá là "điểm cuối" và giá trị là URI cho điểm cuối.

Chỉ có thể thao tác trên khoá bằng một lệnh trên mỗi JSON. Nếu hai lệnh cố hoạt động trên cùng một khoá, phương thức này sẽ thông qua một IllegalArgumentException

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

JSON được truy xuất từ máy chủ không hợp lệ.
URI được cung cấp không hợp lệ.

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ố
`updateSignalsRequest`	`UpdateSignalsRequest`: 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`.