เครื่องมือจัดการ ProtectedSignals

public class ProtectedSignalsManager
extends Object

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


ProtectedSignalsManager มี API สำหรับแอปและ Ad-SDK เพื่อจัดการสัญญาณที่มีการป้องกัน

สรุป

วิธีการสาธารณะ

static ProtectedSignalsManager get(Context context)

วิธีการจากโรงงานสำหรับการสร้างอินสแตนซ์ของ ProtectedSignalsManager

void updateSignals(UpdateSignalsRequest updateSignalsRequest, Executor executor, OutcomeReceiver<ObjectException> receiver)

UpdateSignals API จะเรียก JSON จาก URI ที่อธิบายถึงสัญญาณที่ควรเพิ่ม หรือนำออก

วิธีการที่รับมา

วิธีการสาธารณะ

รับ

public static ProtectedSignalsManager get (Context context)

วิธีการจากโรงงานสำหรับการสร้างอินสแตนซ์ของ ProtectedSignalsManager

พารามิเตอร์
context Context: Context ที่จะใช้ ค่านี้ต้องไม่เป็น null

คิกรีเทิร์น
ProtectedSignalsManager อินสแตนซ์ ProtectedSignalsManager ค่านี้ต้องไม่เป็น null

สัญญาณอัปเดต

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

UpdateSignals API จะเรียก JSON จาก URI ที่อธิบายถึงสัญญาณที่ควรเพิ่ม หรือนำออก API นี้ยังอนุญาตให้ลงทะเบียนอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์ได้ด้วย ระบบใช้ปลายทางเพื่อ ดาวน์โหลดตรรกะการเข้ารหัส ซึ่งจะเปิดใช้การเข้ารหัสสัญญาณ

คีย์ระดับบนสุดของ JSON ต้องสอดคล้องกับคำสั่ง 1 ใน 5 ข้อต่อไปนี้

"put" - เพิ่มสัญญาณใหม่ โดยเขียนทับสัญญาณที่มีอยู่ด้วยคีย์เดียวกัน ค่า เพราะเป็นออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ที่สอดคล้องกับคีย์ที่ใส่ for และค่าจะเป็นสตริงฐาน 64 ที่ตรงกับค่าที่จะใส่

"ต่อท้าย" - เพิ่มสัญญาณ/สัญญาณใหม่ต่อท้ายอนุกรมเวลา โดยนำสัญญาณที่เก่าที่สุดออก เพื่อเพิ่มพื้นที่ว่างสำหรับรายการใหม่ ถ้าขนาดของชุดหนังสือเกินขนาดสูงสุดที่กำหนด ค่าสำหรับกรณีนี้คือออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ที่สอดคล้องกับ คีย์ที่จะต่อท้ายและค่าคือออบเจ็กต์ที่มี 2 ช่อง ได้แก่ "ค่า" และ "maxSignals" ที่ใช้เวลาเพียง 2 นาที "ค่า" คือรายการสตริงฐาน 64 สตริงตามค่าสัญญาณที่จะต่อท้ายเวลา ซีรีส์ "maxSignals" คือจำนวนค่าสูงสุดที่อนุญาตในอนุกรมเวลานี้ ถ้า จำนวนสัญญาณปัจจุบันที่เชื่อมโยงกับคีย์เกิน maxSignals สัญญาณที่เก่าที่สุด จะถูกลบ โปรดทราบว่าคุณสามารถเพิ่มคีย์ที่เพิ่มด้วยคำว่า "put" ได้ ไม่ใช่ว่าการเพิ่มมากกว่า จำนวนค่าสูงสุดจะทำให้การทำงานล้มเหลว

"put_if_not_present" - เพิ่มสัญญาณใหม่เฉพาะกรณีที่ไม่มีสัญญาณเดิมที่มี คีย์เดียวกัน ค่าสำหรับกรณีนี้เป็นออบเจ็กต์ JSON ซึ่งคีย์เป็นสตริงฐาน 64 ตรงกับคีย์ที่จะใส่ และค่าจะเป็นสตริงฐาน 64 ที่สอดคล้องกับ ที่ควรใส่

"นำออก" - นำสัญญาณของคีย์ออก ค่าของรายการนี้คือรายการสตริงฐาน 64 ตามคีย์ของสัญญาณที่ควรลบ

"update_encoder" - มีการทำงานในการอัปเดตปลายทาง และ URI ที่สามารถใช้ได้ เพื่อเรียกตรรกะการเข้ารหัส คีย์ย่อยสำหรับระบุการดำเนินการอัปเดตคือ "action" และ ค่าที่รองรับในปัจจุบัน ได้แก่

  1. "ลงทะเบียน" : ลงทะเบียนอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์ หากให้ไว้เป็นครั้งแรก หรือ เขียนทับรายการที่มีอยู่ด้วยปลายทางที่ระบุใหม่ การระบุ "ปลายทาง" เป็นข้อมูลที่จำเป็นสำหรับขั้นตอน "REGISTER" การดำเนินการ

คีย์ย่อยสำหรับการระบุอุปกรณ์ปลายทางของโปรแกรมเปลี่ยนไฟล์คือ "ปลายทาง" และค่าคือ URI สำหรับปลายทาง

คีย์จะใช้งานได้ด้วยคำสั่ง 1 คำสั่งต่อ JSON เท่านั้น หากมีคำสั่ง 2 รายการที่พยายามดำเนินการ คีย์เดียวกัน วิธีนี้จะดำเนินการผ่าน IllegalArgumentException

การโทรนี้จะล้มเหลวโดยมี SecurityException หาก

  1. ownerPackageName ไม่ได้เรียกชื่อแพ็กเกจของแอปและ/หรือ
  2. ผู้ซื้อไม่ได้รับอนุญาตให้ใช้ API

การโทรนี้จะล้มเหลวโดยมี IllegalArgumentException หาก

  1. JSON ที่ดึงมาจากเซิร์ฟเวอร์ไม่ถูกต้อง
  2. URI ที่ระบุไม่ถูกต้อง

การโทรนี้ล้มเหลวโดยมี LimitExceededException ถ้าแพ็กเกจการโทรเกิน ขีดจำกัดของอัตราที่อนุญาตและถูกควบคุม

การเรียกใช้นี้จะล้มเหลวโดยมี IllegalStateException หากข้อผิดพลาดเกี่ยวกับบริการภายในคือ ที่พบ
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

พารามิเตอร์
updateSignalsRequest UpdateSignalsRequest: ค่านี้ต้องไม่เป็น null

executor Executor: ค่านี้ต้องไม่เป็น null ระบบจะส่งเหตุการณ์ Callback และ Listener ผ่านรายการนี้ Executor มอบวิธีง่ายๆ ในการควบคุมชุดข้อความที่ ในการส่งกิจกรรมผ่านชุดข้อความหลักของ คุณสามารถใช้ Context.getMainExecutor() หรือระบุ Executor ที่ส่งไปยังชุดข้อความที่เหมาะสม

receiver OutcomeReceiver: ค่านี้ต้องไม่เป็น null