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<Object, Exception> receiver)` updateSignals API יאחזר קובץ JSON מה-URI שמתאר אילו אותות להוסיף או הסרה.

שיטות שעברו בירושה

מהכיתה


        
          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 static ProtectedSignalsManager get (Context context)

שיטת היצרן ליצירת מכונה של ProtectedSignalsManager.

פרמטרים
`context`	`Context`: `Context` לשימוש הערך הזה לא יכול להיות `null`.

החזרות
`ProtectedSignalsManager`	מופע של `ProtectedSignalsManager` הערך הזה לא יכול להיות `null`.

updateSignals

נוסף ב-Android UpsideDownCakePrivacySandbox

public void updateSignals (UpdateSignalsRequest updateSignalsRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> 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 שבו ניתן להשתמש כדי לאחזר לוגיקת קידוד. מפתח המשנה לציון פעולת עדכון הוא 'פעולה' את הרצף הערכים הנתמכים כרגע הם:

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

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

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

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

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

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

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

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

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

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