RequestConfiguration.Builder

Kotlin |Java

public class RequestConfiguration.Builder

---

"البنّاء" في RequestConfiguration

ملخّص

وظائف الإنشاء العامة
Builder()

الطرق العامة
RequestConfiguration	build() إنشاء RequestConfiguration
RequestConfiguration.Builder	@CanIgnoreReturnValue setMaxAdContentRating(     @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating ) لضبط الحد الأقصى لتقييم محتوى الإعلان
RequestConfiguration.Builder	@CanIgnoreReturnValue setPublisherPrivacyPersonalizationState(     RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState ) لضبط حالة تخصيص معالجة خصوصية الناشر
RequestConfiguration.Builder	@CanIgnoreReturnValue setTagForChildDirectedTreatment(     @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment ) تتيح لك هذه الطريقة تحديد ما إذا كنت تريد أن يُعامل تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)‏ - http://business.ftc.gov/privacy-and-security/childrens-privacy.
RequestConfiguration.Builder	@CanIgnoreReturnValue setTagForUnderAgeOfConsent(     @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent ) تتيح لك هذه الطريقة وضع علامة على تطبيقك لكي يتم التعامل معه بصفته موجّهًا إلى مستخدمين دون سن الرشد في المنطقة الاقتصادية الأوروبية.
RequestConfiguration.Builder	@CanIgnoreReturnValue setTestDeviceIds(@Nullable List<String> testDeviceIds) تُستخدَم لضبط قائمة بمعرّفات الأجهزة الاختبارية التي تتوافق مع الأجهزة الاختبارية التي ستطلب دائمًا الإعلانات الاختبارية.

وظائف الإنشاء العامة

عامل بناء

public Builder()

الطرق العامة

إنشاء

public RequestConfiguration build()

إنشاء RequestConfiguration

setMaxAdContentRating

@CanIgnoreReturnValue
public RequestConfiguration.Builder setMaxAdContentRating(
    @RequestConfiguration.MaxAdContentRating @Nullable String maxAdContentRating
)

لضبط الحد الأقصى لتقييم محتوى الإعلان وسيكون لإعلانات AdMob التي يتم عرضها لتطبيقك تقييم للمحتوى يساوي هذا المستوى أو أقلّ منه. القيم الصالحة هي MAX_AD_CONTENT_RATING_G وMAX_AD_CONTENT_RATING_PG وMAX_AD_CONTENT_RATING_T وMAX_AD_CONTENT_RATING_MA.

setPublisherPrivacyPersonalizationState

@CanIgnoreReturnValue
public RequestConfiguration.Builder setPublisherPrivacyPersonalizationState(
    RequestConfiguration.PublisherPrivacyPersonalizationState publisherPrivacyPersonalizationState
)

لضبط حالة تخصيص معالجة خصوصية الناشر

setTagForChildDirectedTreatment

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForChildDirectedTreatment(
    @RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment
)

تتيح لك هذه الطريقة تحديد ما إذا كنت تريد أن يُعامل تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA)‏ - http://business.ftc.gov/privacy-and-security/childrens-privacy.

في حال ضبط هذه الطريقة على TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE، يعني ذلك أنّه يجب التعامل مع تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

في حال ضبط هذه الطريقة على TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE، يعني ذلك أنّه يجب عدم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال لأغراض قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

في حال عدم ضبط هذه الطريقة أو ضبطها على TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED، لن تتضمّن طلبات الإعلانات أي إشارة إلى الطريقة التي تريد أن يعامل بها تطبيقك بموجب قانون حماية خصوصية الأطفال على الإنترنت (COPPA).

من خلال ضبط هذه الطريقة، أنت تقرّ بأنّ هذا الإشعار دقيق وأنّك مخوّل بالتصرف نيابةً عن مالك التطبيق. وأنت تدرك أنّ إساءة استخدام هذا الإعداد قد تؤدي إلى إغلاق حسابك على Google.

ملاحظة: قد يستغرق الأمر بعض الوقت حتى يتم تنفيذ هذه الإجراءات في خدمات Google السارية.

المعلمات
@RequestConfiguration.TagForChildDirectedTreatment int tagForChildDirectedTreatment	اضبط القيمة على true للإشارة إلى أنّه يجب التعامل مع تطبيقك على أنّه موجّه إلى الأطفال. اضبط القيمة على false للإشارة إلى أنّه يجب عدم التعامل مع تطبيقك على أنّه موجّه إلى الأطفال.

setTagForUnderAgeOfConsent

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTagForUnderAgeOfConsent(
    @RequestConfiguration.TagForUnderAgeOfConsent int tagForUnderAgeOfConsent
)

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

عند استخدام هذه الميزة، سيتم تضمين مَعلمة "علامة المستخدمين تحت سن الرشد في أوروبا" (TFUA) في جميع طلبات الإعلانات. تؤدي هذه المَعلمة إلى إيقاف الإعلانات المخصّصة، بما في ذلك تجديد النشاط التسويقي، لطلب الإعلان المحدّد هذا. تعمل الميزة أيضًا على إيقاف الطلبات إلى مورّدي الإعلانات من جهات خارجية، مثل وحدات البكسل لقياس الإعلانات وخوادم الإعلانات من جهة خارجية.

في حال ضبط هذه الطريقة على TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE، يعني ذلك أنّك تريد أن يتم التعامل مع تطبيقك بطريقة مناسبة للمستخدمين دون سن الرشد.

في حال ضبط هذه الطريقة على TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE، يعني ذلك أنّك لا تريد أن يتم التعامل مع تطبيقك بطريقة مناسبة للمستخدمين الذين تقلّ أعمارهم عن سن الرشد.

في حال عدم ضبط هذه الطريقة أو ضبطها على TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED، لن يتضمّن تطبيقك أي إشارة إلى الطريقة التي تريد أن يتعامل بها التطبيق مع المستخدمين الذين تقلّ أعمارهم عن سن الموافقة.

setTestDeviceIds

@CanIgnoreReturnValue
public RequestConfiguration.Builder setTestDeviceIds(@Nullable List<String> testDeviceIds)

تُستخدَم لضبط قائمة بمعرّفات الأجهزة الاختبارية التي تتوافق مع الأجهزة الاختبارية التي ستطلب دائمًا الإعلانات الاختبارية. يتم تسجيل معرّف الجهاز التجريبي للجهاز الحالي في logcat عند إجراء أول طلب إعلان.

المعلمات
@Nullable List<String> testDeviceIds	قائمة أرقام تعريف الأجهزة الاختبارية مرِّر null لمحو القائمة.

المرتجعات
RequestConfiguration.Builder	Builder