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 หาก

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

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

แอปพลิเคชันการโทรเกินขีดจำกัดพื้นที่เก็บข้อมูลแล้ว และ/หรือ
พารามิเตอร์ 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 ที่ระบุ

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

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

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

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

พารามิเตอร์
`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 หาก

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

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

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