ProtectedSignalsManager

public class ProtectedSignalsManager
extends Object

java.lang.Object
↳	android.adservices.إشارات.ProtectedSignalsManager

توفّر ProtectedSignalsManager واجهات برمجة تطبيقات للتطبيقات وحِزم تطوير البرامج (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()` تعرض قيمة رمز التجزئة للكائن.
`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`.

تحديث الإشارات

تمت الإضافة في Android UpsideDownCakePrivacySandbox

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

ستسترد واجهة UpdateSignals API ملف JSON من معرّف الموارد المنتظم (URI) الذي يصف الإشارات التي يجب إضافتها. أو إزالتها. تسمح واجهة برمجة التطبيقات هذه أيضًا بتسجيل نقطة نهاية برنامج التشفير. تستخدم نقطة النهاية تنزيل منطق تشفير يمكِّن ترميز الإشارات.

يجب أن تتوافق مفاتيح المستوى الأعلى لتنسيق JSON مع أحد الأوامر الخمسة:

"بوت" - إضافة إشارة جديدة، بدلاً من أي إشارات حالية تستخدم المفتاح نفسه القيمة فيما يلي كائن JSON حيث تكون المفاتيح عبارة عن سلاسل أساسية 64 تتوافق مع المفتاح لوضع for والقيم هي سلسلة Base 64 المقابلة للقيمة المراد وضعها.

"إلحاق" - إلحاق إشارة/إشارات جديدة بسلسلة زمنية من الإشارات، وإزالة الأقدم لإفساح المجال للإعلانات الجديدة إذا تجاوز حجم السلسلة الحد الأقصى المعين. وتكون قيمة هذه هي كائن JSON حيث تكون المفاتيح عبارة عن سلاسل أساسية 64 تتوافق مع يتم إلحاق المفتاح بـ والقيم عبارة عن كائنات تحتوي على حقلين: "القيم" و"maxSignals" . "القيم" عبارة عن قائمة من سلاسل الأساس 64 المقابلة لقيم الإشارة التي يجب إلحاقها بالوقت السلسلة. "maxSignals" هو الحد الأقصى لعدد القيم المسموح بها في هذا السلسلة الزمنية. في حال حذف يتجاوز العدد الحالي للإشارات المرتبطة بالمفتاح الحد الأقصى للإشارات الأقدم ستتم إزالته. تجدر الإشارة إلى أنّه يمكنك إلحاقه بمفتاح مُضاف باستخدام وضع إدخال. لا يعني ذلك أن إلحاق أكثر من فإن الحد الأقصى لعدد القيم سيؤدي إلى الإخفاق.

"put_if_not_present" - لا تتم إضافة إشارة جديدة إلا إذا لم تكن هناك إشارات حالية تحتوي على نفس المفتاح. قيمة هذه هي كائن JSON حيث تكون المفاتيح عبارة عن سلاسل من أساس 64 تتجاوب مع المفتاح المطلوب وضعها والقيم هي سلسلة 64 الأساسية المقابلة التي ينبغي وضعها.

"إزالة" - إزالة إشارة أحد المفاتيح وتكون قيمة هذه قائمة من سلاسل الأساس 64. بشكل يتوافق مع مفاتيح الإشارات التي يجب حذفها.

"update_encoder" - توفير إجراء لتحديث نقطة النهاية ومعرّف الموارد المنتظم (URI) الذي يمكن استخدامه لاسترداد منطق الترميز. المفتاح الفرعي لتوفير إجراء التحديث هو "action" و القيم المتاحة حاليًا هي:

REGISTER : لتسجيل نقطة نهاية برنامج التشفير إذا تم توفيرها لأول مرة أو يستبدل نقطة النهاية الحالية بنقطة النهاية التي تم تقديمها حديثًا. توفير "نقطة النهاية" مطلوبة لـ "REGISTER" اتخاذ القرار.

والمفتاح الفرعي لتوفير نقطة نهاية برنامج التشفير هو "نقطة نهاية" والقيمة هي عنوان URI لنقطة النهاية.

لا يمكن تشغيل المفتاح إلا من خلال أمر واحد لكل JSON. إذا حاول اثنان من الأوامر العمل على نفس المفتاح، سوف يتم تنفيذ هذه الطريقة من خلال IllegalArgumentException

يتعذّر إتمام هذه المكالمة مع SecurityException إذا

تعذّر على ownerPackageName الاتصال باسم حزمة التطبيق و/أو
لا يُسمح للمشتري باستخدام واجهة برمجة التطبيقات.

يتعذّر إتمام هذه المكالمة مع IllegalArgumentException إذا

ملف JSON الذي تم استرداده من الخادم غير صالح.
معرّف الموارد المنتظم (URI) الذي تم تقديمه غير صالح.

يتعذّر إجراء هذه المكالمة مع "LimitExceededException" إذا تجاوز حزمة الاتصال المسموح بها لمعدل الزيارات ويتم تقييدها.

يتعذّر إتمام هذا الاتصال مع رمز IllegalStateException إذا كان هناك خطأ داخلي في الخدمة واجهناها.
يتطلب AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

المعلمات
`updateSignalsRequest`	`UpdateSignalsRequest`: لا يمكن أن تكون هذه القيمة `null`.
`executor`	`Executor`: لا يمكن أن تكون هذه القيمة `null`. يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال هذا `Executor`، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات استخدام البيانات المختلفة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية التطبيق، فيمكنك استخدام `Context.getMainExecutor()` وبخلاف ذلك، يُرجى توفير `Executor` يتم إرسالها إلى سلسلة محادثات مناسبة.
`receiver`	`OutcomeReceiver`: لا يمكن أن تكون هذه القيمة `null`.