ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

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


ProtectedSignalsManager מספק ממשקי API לאפליקציות וערכות 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.

updateSignals

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

updateSignals API יאחזר קובץ JSON מה-URI שמתאר אילו אותות להוסיף או הסרה. ה-API הזה מאפשר גם לרשום את נקודת הקצה של המקודד. נקודת הקצה משמשת להוריד לוגיקת קידוד שמאפשרת לקודד את האותות.

המפתחות ברמה העליונה של ה-JSON חייבים להתאים לאחת מ-5 פקודות:

"put" - הוספת אות חדש והחלפת אותות קיימים באותו מפתח. הערך בשביל זה הוא אובייקט JSON שבו המפתחות הם מחרוזות בסיס 64 שתואמות למפתח שיש להציב. והערכים הם מחרוזת בבסיס 64 שתואמת לערך שרוצים להציב.

'append' - מצרף אות/אות חדשים לרצף זמן של אותות, תוך הסרת האלמנטים הישנים ביותר כדי לפנות מקום לסדרות החדשות אם גודל הסדרות חורג מהמקסימום הנתון. הערך הזה הוא אובייקט JSON שבו המפתחות הם מחרוזות בסיס 64 שתואמות המפתח לצירוף, והערכים הם אובייקטים עם שני שדות: 'ערכים' ו-maxSignals הקצר הזה. התשובות שלך יעזרו לנו להשתפר. 'values' היא רשימה של מחרוזות בסיס 64 שמתאימות לאותת לערכים שצריך לצרף לשעה סדרות. 'maxSignals' הוא מספר הערכים המקסימלי המותר בסדרי זמנים אלה. אם המיקום מספר האותות הנוכחי שמשויך למפתח חורג מ-maxSignals מהאותות הישנים ביותר יוסר. לתשומת ליבכם: אפשר לצרף למפתח שנוסף על ידי 'איפה'. לא כל הסיומת מספר הערכים המקסימלי יגרום לכשל.

'put_if_not_present' - הוספת אות חדש רק אם אין אותות קיימים עם מקש זהה. הערך של האובייקט הזה הוא אובייקט JSON שבו המפתחות הם מחרוזות של בסיס 64 שתואם למפתח שיש להזין, והערכים הם מחרוזת של בסיס 64 שתואמת שצריך להקצות.

"remove" (הסרה) - הסרת האות של מפתח. הערך הזה הוא רשימה של מחרוזות בסיס 64 שתואם למפתחות של האותות שצריך למחוק.

'update_encoder' - מספקת פעולה לעדכון נקודת הקצה ו-URI שבו ניתן להשתמש כדי לאחזר לוגיקת קידוד. מפתח המשנה לציון פעולת עדכון הוא 'פעולה' את הרצף הערכים הנתמכים כרגע הם:

  1. REGISTER [הרשמה] : רושם את נקודת הקצה של המקודד אם היא סופקה בפעם הראשונה, או מחליפה את הנכס הקיים בנקודת הקצה החדשה שסופקה. ציון נקודת הקצה נדרש עבור הרישום REGISTER פעולה.

מפתח המשנה לאספקת נקודת הקצה במקודד הוא 'נקודת קצה' והערך הוא ה-URI של נקודת הקצה.

ניתן להפעיל את המפתח באמצעות פקודה אחת בלבד לכל JSON. אם שתי פקודות מנסות לפעול על אותו מפתח, השיטה הזו תעבור דרך IllegalArgumentException

השיחה הזו תיכשל עם SecurityException אם

  1. ownerPackageName לא קורא לשם החבילה של האפליקציה ו/או
  2. הקונה אינו מורשה להשתמש בממשק ה-API.

השיחה הזו תיכשל עם IllegalArgumentException אם

  1. קובץ ה-JSON שאוחזר מהשרת אינו חוקי.
  2. ה-URI שצוין לא חוקי.

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

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

פרמטרים
updateSignalsRequest UpdateSignalsRequest: הערך הזה לא יכול להיות null.

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

receiver OutcomeReceiver: הערך הזה לא יכול להיות null.