מנהל הקהלים בהתאמה אישית

public class CustomAudienceManager
extends Object

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

CustomAudienceManager מספק ממשקי API לערכות SDK של אפליקציות וערכות 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()` מחזירה ערך גיבוב (hash) של האובייקט.
`final void`	`notify()` הוצאת שרשור יחיד שממתין לאובייקט מעקב.
`final void`	`notifyAll()` פעולה זו מוציאה את כל השרשורים שממתינים למסך של האובייקט הזה.
`String`	`toString()` מחזירה ייצוג במחרוזת של האובייקט.
`final void`	`wait(long timeoutMillis, int nanos)` גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת.
`final void`	`wait(long timeoutMillis)` גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל באמצעות התראה או הפרעה, או עד מתבצע פרק זמן מסוים בזמן אמת.
`final void`	`wait()` גורם לשרשור הנוכחי להמתין עד שהוא מופעל, בדרך כלל על ידי קבלת התראה או הפרעה.

שיטות ציבוריות

אחזור והצטרפותמותאם אישית

נוסף ב-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 אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

הקריאה הזו תיכשל עם IllegalStateException אם אירעה שגיאה פנימית בשירות המערכת נתקלה בבעיה.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

פרמטרים
`fetchAndJoinCustomAudienceRequest`	`FetchAndJoinCustomAudienceRequest`: הערך הזה לא יכול להיות `null`.
`executor`	`Executor`: הערך הזה לא יכול להיות `null`. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות `Executor`, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש `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.

השיחה תיכשל עם LimitExceededException אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

פרמטרים
`joinCustomAudienceRequest`	`JoinCustomAudienceRequest`: הערך הזה לא יכול להיות `null`.
`executor`	`Executor`: הערך הזה לא יכול להיות `null`. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות `Executor`, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש `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.

השיחה תיכשל עם LimitExceededException אם חבילת השיחה חורגת מה לקצב שליחת בקשות, ומתבצעת ויסות נתונים (throttle).

השיחה לא מיידעת את המתקשר אם הקהל בהתאמה אישית שצוין קיים באחסון במכשיר. במילים אחרות, הרכישה תיכשל באופן שקט כאשר קונה ינסה לעזוב קהל בהתאמה אישית שלא צורף לערוץ.
נדרש AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

פרמטרים
`leaveCustomAudienceRequest`	`LeaveCustomAudienceRequest`: הערך הזה לא יכול להיות `null`.
`executor`	`Executor`: הערך הזה לא יכול להיות `null`. אירועי קריאה חוזרת ואירועי האזנה נשלחים באמצעות `Executor`, דרך קלה לקבוע איזה שרשור בשימוש. כדי לשלוח אירועים דרך ה-thread הראשי אפשר להשתמש `Context.getMainExecutor()` אם לא, צריך לציין `Executor` ששולח לשרשור מתאים.
`receiver`	`OutcomeReceiver`: הערך הזה לא יכול להיות `null`.