ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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

ProtectedSignalsManager menyediakan API untuk aplikasi dan SDK iklan agar dapat mengelola sinyal terlindungi.

Ringkasan

Metode publik
`static ProtectedSignalsManager`	`get(Context context)` Metode factory untuk membuat instance ProtectedSignalsManager.
`void`	`updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)` updateSignals API akan mengambil JSON dari URI yang menjelaskan sinyal mana yang akan ditambahkan atau hapus.

Metode turunan

Dari class


        
          java.lang.Object

`Object`	`clone()` Membuat dan menampilkan salinan objek ini.
`boolean`	`equals(Object obj)` Menunjukkan apakah beberapa objek lain "sama dengan" objek ini atau tidak.
`void`	`finalize()` Dipanggil oleh pembersih sampah memori pada sebuah objek saat pembersihan sampah memori menentukan bahwa tidak ada lagi referensi ke objek.
`final Class<?>`	`getClass()` Menampilkan class runtime dari `Object` ini.
`int`	`hashCode()` Menampilkan nilai kode hash untuk objek.
`final void`	`notify()` Mengaktifkan satu thread yang menunggu di monitor objek ini.
`final void`	`notifyAll()` Mengaktifkan semua thread yang menunggu di monitor objek ini.
`String`	`toString()` Menampilkan representasi string dari objek ini.
`final void`	`wait(long timeoutMillis, int nanos)` Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu.
`final void`	`wait(long timeoutMillis)` Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu.
`final void`	`wait()` Membuat thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu.

Metode publik

get

Ditambahkan di Android UpsideDownCakePrivacySandbox

public static ProtectedSignalsManager get (Context context)

Metode factory untuk membuat instance ProtectedSignalsManager.

Parameter
`context`	`Context`: `Context` yang akan digunakan Nilai ini tidak boleh `null`.

Hasil
`ProtectedSignalsManager`	Instance `ProtectedSignalsManager` Nilai ini tidak boleh `null`.

updateSignals

Ditambahkan di Android UpsideDownCakePrivacySandbox

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

updateSignals API akan mengambil JSON dari URI yang menjelaskan sinyal mana yang akan ditambahkan atau hapus. API ini juga memungkinkan pendaftaran endpoint encoder. Endpoint digunakan untuk mengunduh logika pengkodean, yang memungkinkan penyandian sinyal.

Kunci tingkat teratas untuk JSON harus sesuai dengan salah satu dari 5 perintah:

"pasang" - Menambahkan sinyal baru agar dapat menimpa sinyal yang ada dengan kunci yang sama. Nilainya untuk ini adalah objek JSON dengan kunci berupa string basis 64 yang sesuai dengan kunci yang akan dimasukkan dan nilainya adalah string basis 64 yang sesuai dengan nilai yang akan dimasukkan.

"tambahkan" - Menambahkan satu/beberapa sinyal baru ke deret waktu sinyal agar dapat menghapus sinyal terlama untuk memberi ruang bagi yang baru jika ukuran deret melebihi batas maksimum yang ditentukan. Nilai untuk ini adalah objek JSON dengan kunci berupa string basis 64 yang sesuai dengan kunci yang akan ditambahkan dan nilainya adalah objek dengan dua kolom: "values" dan "maxSignals" kami. "nilai" adalah daftar string basis 64 yang sesuai dengan nilai sinyal yang akan ditambahkan ke waktu Workspace kami. "maxSignals" adalah jumlah nilai maksimum yang diizinkan dalam deret waktu ini. Jika jumlah sinyal saat ini yang terkait dengan kunci melebihi maxSignals sinyal terlama akan dihapus. Perhatikan bahwa Anda dapat menambahkan ke kunci yang ditambahkan oleh put. Bukan berarti menambahkan lebih dari jumlah nilai maksimum akan menyebabkan kegagalan.

"put_if_not_present" (put_jika_tidak_tersedia) - Menambahkan sinyal baru hanya jika tidak ada sinyal dengan tombol yang sama. Nilai untuk ini adalah objek JSON dengan kunci berupa string basis 64 sesuai dengan kunci yang akan dimasukkan dan nilainya adalah {i>string<i} basis 64 yang sesuai dengan nilai untuk dimasukkan.

"hapus" - Menghapus sinyal untuk kunci. Nilainya adalah daftar string basis 64 sesuai dengan kunci sinyal yang harus dihapus.

"update_encoder" - Menyediakan tindakan untuk mengupdate endpoint, dan URI yang dapat digunakan untuk mengambil logika encoding. Sub-kunci untuk memberikan tindakan update adalah "tindakan" dan nilai yang saat ini didukung adalah:

"DAFTAR" : Mendaftarkan endpoint encoder jika diberikan untuk pertama kali atau akan menimpa endpoint yang ada dengan endpoint yang baru disediakan. Menyediakan "endpoint" diperlukan untuk kolom "REGISTER" tindakan.

Sub-kunci untuk memberikan endpoint encoder adalah "endpoint" dan nilainya adalah URI string URI untuk endpoint.

Kunci hanya dapat dioperasikan oleh satu perintah per JSON. Jika dua perintah mencoba beroperasi pada kunci yang sama, metode ini akan melalui IllegalArgumentException

Panggilan ini gagal dengan SecurityException jika

ownerPackageName tidak memanggil nama paket aplikasi dan/atau
pembeli tidak diberi otorisasi untuk menggunakan API.

Panggilan ini gagal dengan IllegalArgumentException jika

JSON yang diambil dari server tidak valid.
URI yang diberikan tidak valid.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi dan dibatasi kapasitasnya.

Panggilan ini gagal dengan IllegalStateException jika error layanan internal temui.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
`updateSignalsRequest`	`UpdateSignalsRequest`: Nilai ini tidak boleh `null`.
`executor`	`Executor`: Nilai ini tidak boleh `null`. Peristiwa callback dan pemroses dikirim melalui ini `Executor`, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan `Context.getMainExecutor()`. Jika tidak, sediakan `Executor` yang melakukan pengiriman ke thread yang sesuai.
`receiver`	`OutcomeReceiver`: Nilai ini tidak boleh `null`.