طلب UpdateAdCounterHistogram

public class UpdateAdCounterHistogramRequest
extends Object

java.lang.Object
↳	android.adservices.adselection.UpdateAdCounterHistogramRequest

طلب عنصر يلتف الوسيطات المطلوبة لتعديل مدرج تكراري لعدّاد الإعلانات.

المدرجات التكرارية لعدّاد الإعلانات، وهي سجلات تاريخية للأحداث المرتبطة بأحد الإعلانات والمفتاح المضاد ونوع حدث الإعلان، يُستخدمان لإجراء فلترة لتحديد عدد مرات الظهور عند استخدام Protected Audience API

ملخّص

الصفوف المتداخلة
`class`	`UpdateAdCounterHistogramRequest.Builder` أداة إنشاء `UpdateAdCounterHistogramRequest` عنصر

الطرق العامة
`boolean`	`equals(Object o)` للتحقّق مما إذا كانت كائنات `UpdateAdCounterHistogramRequest` تحتوي على القيم نفسها المعلومات.
`int`	`getAdEventType()` تتيح هذه الميزة الحصول على نوع حدث الإعلان، الذي يحدد المدرّج التكراري للإعلانات، إلى جانب مفاتيح عدّاد الإعلان. .
`long`	`getAdSelectionId()` الحصول على رقم تعريف اختيار الإعلان الذي ترتبط به أحداث الإعلان المعروض
`AdTechIdentifier`	`getCallerAdTech()` يحصل على `AdTechIdentifier` لكيان تكنولوجيا الإعلان الخاص بالمتصل.
`int`	`hashCode()` تعرض تجزئة بيانات عنصر `UpdateAdCounterHistogramRequest`.
`String`	`toString()` تعرض تمثيلاً سلسلة للكائن.

الطرق المكتسبة

من الصف


        
          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 boolean equals (Object o)

للتحقّق مما إذا كانت كائنات UpdateAdCounterHistogramRequest تحتوي على القيم نفسها المعلومات.

المعلمات
`o`	`Object`: الكائن المرجعي المطلوب المقارنة معه

المرتجعات
`boolean`	`true` إذا كان هذا الكائن مطابقًا للنوع obj الوسيطة؛ `false` بخلاف ذلك.

نوع getAdEventType

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

public int getAdEventType ()

تتيح هذه الميزة الحصول على نوع حدث الإعلان، الذي يحدد المدرّج التكراري للإعلانات، إلى جانب مفاتيح عدّاد الإعلان. .

المرتجعات

المرتجعات
`int`	القيمة هي android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_disable، أو `FrequencyCapFilters.AD_EVENT_TYPE_WIN`، أو `FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION`، أو `FrequencyCapFilters.AD_EVENT_TYPE_VIEW`، أو `FrequencyCapFilters.AD_EVENT_TYPE_CLICK`، أو android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MIN، أو android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MAX

int

القيمة هي android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_disable، أو FrequencyCapFilters.AD_EVENT_TYPE_WIN، أو FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION، أو FrequencyCapFilters.AD_EVENT_TYPE_VIEW، أو FrequencyCapFilters.AD_EVENT_TYPE_CLICK، أو android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MIN، أو android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MAX

رقم تعريف getAdSelection

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

public long getAdSelectionId ()

الحصول على رقم تعريف اختيار الإعلان الذي ترتبط به أحداث الإعلان المعروض

لمزيد من المعلومات عن رقم تعريف اختيار الإعلانات، يُرجى الاطّلاع على AdSelectionOutcome.

يجب أن يكون الإعلان قد تم اختياره خلال آخر 24 ساعة من خلال اختيار إعلان Protected Audience API. ويجب أن يكون قد تم بدء طلب اختيار الإعلان من التطبيق نفسه الذي يتم الاتصال به حاليًا التطبيق. المدرّجات التكرارية للأحداث لجميع مفاتيح عدّاد الإعلانات المرتبطة بالإعلان الذي حدّده الإعلان سيتم تعديل رقم تعريف الاختيار لنوع حدث الإعلان من getAdEventType()، لاستخدامه. في فلترة تحديد عدد مرات الظهور للجمهور المحمي

المرتجعات
`long`

getCallerAdTech

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

public AdTechIdentifier getCallerAdTech ()

يحصل على AdTechIdentifier لكيان تكنولوجيا الإعلان الخاص بالمتصل.

يجب أن تكون تقنية الإعلان التي تستخدم عنصر UpdateAdCounterHistogramRequest هذا مسجّلةً باستخدام "مبادرة حماية الخصوصية" ويُسمح لها بالتصرف نيابةً عن تطبيق الاتصال. المحددة لا يلزم أن تكون تكنولوجيا الإعلان هي نفسها تقنية الإعلان التي يستخدمها المشتري الذي يملك الإعلان المعروض. أو البائع الذي بدأ عملية اختيار الإعلان المرتبط بالمعرّف الذي تم عرضه من خلال getAdSelectionId().

لمزيد من المعلومات حول متطلبات واستثناءات واجهة برمجة التطبيقات، يُرجى الاطّلاع على AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver).

المرتجعات
`AdTechIdentifier`	لا يمكن أن تكون هذه القيمة `null`.

رمز التجزئة

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

public int hashCode ()

تعرض تجزئة بيانات عنصر UpdateAdCounterHistogramRequest.

المرتجعات
`int`	قيمة رمز التجزئة لهذا الكائن.

إلىسلسلة

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

public String toString ()

تعرض تمثيلاً سلسلة للكائن. بشكل عام، تُرجع طريقة toString سلسلة "يمثل نصيًا" لهذا الكائن. يجب أن تكون النتيجة أن يكون تمثيلاً موجزًا وغنيًا بالمعلومات ويسهل على الشخص المراد قراءته. من المستحسن أن تتجاهل جميع الفئات الفرعية هذه الطريقة.

استخدام الطريقة toString للفئة Object تُنتج سلسلة تتكون من اسم الفئة التي هو مثيل، فإن حرف علامة @ `@'، التمثيل السداسي العشري غير الموقع لرمز التجزئة الخاص بك. بعبارة أخرى، تُرجع هذه الطريقة سلسلة تساوي قيمة:

 getClass().getName() + '@' + Integer.toHexString(hashCode())

المرتجعات
`String`	تمثيل سلسلة للكائن.