เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย

สรุป: เมธอด | วิธีการที่รับมา

CustomAudienceManager

public class CustomAudienceManager
extends Object

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

---

CustomAudienceManager มี API สำหรับแอปและ Ad-SDK เพื่อเข้าร่วม / ออกจากกลุ่มเป้าหมายที่กำหนดเอง

สรุป

วิธีการสาธารณะ
void	fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) เพิ่มผู้ใช้ใน CustomAudience ที่ดึงข้อมูลมาจาก fetchUri
static CustomAudienceManager	get(Context context) วิธีการจากโรงงานสำหรับการสร้างอินสแตนซ์ของ CustomAudienceManager
TestCustomAudienceManager	getTestCustomAudienceManager() สร้างบริการด้วย API ที่เปิดใช้การทดสอบ
void	joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) เพิ่มผู้ใช้ไปยัง CustomAudience ที่ระบุ
void	leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) ความพยายามที่จะนําผู้ใช้ออกจากกลุ่มเป้าหมายที่กําหนดเองโดยลบข้อมูล CustomAudience ที่มีอยู่ ซึ่งระบุโดย ownerPackageName, buyer และ name

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

จากชั้นเรียน วันที่ java.lang.Object Object clone() สร้างและแสดงผลสำเนาของออบเจ็กต์นี้ boolean equals(Object obj) ระบุว่าออบเจ็กต์อื่นบางรายการเป็น "เท่ากับ" หรือไม่ อันนี้ void finalize() เรียกใช้โดยผู้เก็บขยะในออบเจ็กต์เมื่อเก็บรวบรวมขยะ ทำให้ทราบว่าไม่มีการอ้างอิงไปยังออบเจ็กต์นั้นแล้ว final Class<?> getClass() แสดงผลคลาสรันไทม์ของ Object นี้ int hashCode() แสดงผลค่ารหัสแฮชสำหรับออบเจ็กต์ final void notify() สร้างชุดข้อความเดียวที่รออยู่ในออบเจ็กต์นี้ จอภาพ final void notifyAll() ปลุกชุดข้อความทั้งหมดที่รออยู่บนจอภาพของออบเจ็กต์นี้ String toString() แสดงผลตัวแทนสตริงของออบเจ็กต์ final void wait(long timeoutMillis, int nanos) ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว final void wait(long timeoutMillis) ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน หรือจนกว่า เวลาแบบเรียลไทม์ผ่านไปแล้ว final void wait() ทำให้เทรดปัจจุบันต้องรอจนกว่าจะมีการปลุก ซึ่งโดยปกติแล้ว ด้วยการแจ้งหรือรบกวน

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

FetchAndjoinCustomAudience

เพิ่มใน Android UpsideDownCakePrivacySandbox

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

เพิ่มผู้ใช้ใน CustomAudience ที่ดึงข้อมูลมาจาก fetchUri

การพยายามลงทะเบียนผู้ใช้สำหรับกลุ่มเป้าหมายที่กำหนดเองโดยใช้ ownerPackageName, buyer และ name เหมือนกันจะทำให้กลุ่มเป้าหมายที่กำหนดเองที่มีอยู่ ข้อมูลที่ถูกเขียนทับ ซึ่งรวมถึงรายการข้อมูลโฆษณา

โปรดทราบว่างานดึงข้อมูลพื้นหลังรายวันสามารถเขียนทับรายการโฆษณาได้ทั้งหมด

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

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

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

1. แอปพลิเคชันการโทรเกินขีดจำกัดพื้นที่เก็บข้อมูลแล้ว และ/หรือ
2. พารามิเตอร์ URI ใน CustomAudience ที่ระบุไม่ได้รับการตรวจสอบสิทธิ์กับ ผู้ซื้อ CustomAudience ราย

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

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

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

รับ

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 6 อีกด้วย

public static CustomAudienceManager get (Context context)

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

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

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

getTestCustomAudienceManager

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย

public TestCustomAudienceManager getTestCustomAudienceManager ()

สร้างบริการด้วย API ที่เปิดใช้การทดสอบ

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

เข้าร่วมกลุ่มเป้าหมายที่กำหนดเอง

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย

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

เพิ่มผู้ใช้ไปยัง CustomAudience ที่ระบุ

การพยายามลงทะเบียนผู้ใช้สำหรับกลุ่มเป้าหมายที่กำหนดเองโดยใช้ ownerPackageName, buyer และ name เหมือนกันจะทำให้กลุ่มเป้าหมายที่กำหนดเองที่มีอยู่ ข้อมูลที่ถูกเขียนทับ ซึ่งรวมถึงรายการข้อมูลโฆษณา

โปรดทราบว่างานดึงข้อมูลพื้นหลังรายวันสามารถเขียนทับรายการโฆษณาได้ทั้งหมด

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

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

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

1. แอปพลิเคชันการโทรเกินขีดจำกัดพื้นที่เก็บข้อมูลแล้ว และ/หรือ
2. พารามิเตอร์ URI ใน CustomAudience ที่ระบุไม่ได้รับการตรวจสอบสิทธิ์กับ ผู้ซื้อ CustomAudience ราย

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

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

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

ออกจากกลุ่มเป้าหมายที่กำหนดเอง

เพิ่มใน API ระดับ 34
ยังมีในส่วนขยายโฆษณา 4 ด้วย

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

ความพยายามที่จะนําผู้ใช้ออกจากกลุ่มเป้าหมายที่กําหนดเองโดยลบข้อมูล CustomAudience ที่มีอยู่ ซึ่งระบุโดย ownerPackageName, buyer และ name

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

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

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

การโทรนี้ไม่ได้แจ้งให้ผู้โทรทราบว่ามีกลุ่มเป้าหมายที่กำหนดเองที่ระบุอยู่ใน พื้นที่เก็บข้อมูลในอุปกรณ์ กล่าวอีกนัยหนึ่งคือ การเสนอราคาจะล้มเหลวเลยเมื่อผู้ซื้อพยายามออกจาก กลุ่มเป้าหมายที่กำหนดเองที่ยังไม่ได้เข้าร่วม
ต้องใช้ AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

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