الإعداد

توضّح هذه الصفحة كيفية إعداد تطبيقك أو لعبتك لاستخدام واجهة برمجة التطبيقات Play Integrity API. عليك تفعيل الردود الواردة من واجهة برمجة التطبيقات، ثم دمج واجهة برمجة التطبيقات في تطبيقك وخادم الخلفية الخاص به. تصبح خيارات الضبط الإضافية وميزات الاختبار وإعداد التقارير متاحة بعد ربط مشروع Google Cloud الذي تستخدمه مع واجهة برمجة التطبيقات Play Integrity API في Google Play Console.

تفعيل الردود من واجهة برمجة التطبيقات Play Integrity API

يجب أن يستخدِم كل تطبيق أو حزمة SDK تستدعي واجهة برمجة التطبيقات Play Integrity API مشروعًا على Google Cloud لتتبُّع استخدام واجهة برمجة التطبيقات. يمكن للتطبيقات على Google Play ربط مشروع على Cloud في Google Play Console لتفعيل الردود من واجهة برمجة التطبيقات Play Integrity API. إذا أردت إنشاء مشروع جديد على Cloud أو إذا كان تطبيقك موزَّعًا حصريًا خارج Google Play، يمكنك تفعيل الردود من واجهة برمجة التطبيقات Play Integrity API من "وحدة تحكّم Google Cloud".

الإعداد في Google Play Console (إجراء مقترَح)

من خلال تفعيل استجابات واجهة برمجة التطبيقات Play Integrity API في Google Play Console، ستتمكّن من الوصول إلى خيارات ضبط إضافية وميزات اختبار وإعداد تقارير عن واجهة برمجة التطبيقات. لا يتوفّر هذا الخيار إلا للتطبيقات التي يتم توزيعها على Google Play. انتقِل إلى الإصدار > سلامة التطبيق. ضمن Play Integrity API، اختَر ربط مشروع على Cloud. اختَر مشروع Cloud الذي تريد ربطه بتطبيقك، وسيؤدي ذلك إلى تفعيل الردود من Play Integrity API. يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك.

الإعداد في Google Cloud Console

في Google Cloud Console، أنشِئ مشروعًا جديدًا على Cloud أو اختَر مشروعًا حاليًا على Cloud تريد استخدامه مع واجهة برمجة التطبيقات Play Integrity API. انتقِل إلى واجهات برمجة التطبيقات والخدمات. انقر على تفعيل واجهات برمجة التطبيقات والخدمات. ابحث عن واجهة برمجة التطبيقات Play Integrity API ثم فعِّلها. يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك.

تعليمات الإعداد لموفّري حِزم SDK

على موفّري حِزم SDK استخدام مشروعهم على Google Cloud لاستدعاء واجهة برمجة التطبيقات Play Integrity API، وذلك لتحديد مصدر استخدام واجهة برمجة التطبيقات على أنّه حزمة SDK وليس التطبيقات الفردية التي تستخدم حزمة SDK. وهذا يعني أنّ التطبيقات التي تستخدم حزمة SDK الخاصة بك لن تحتاج إلى إعداد واجهة برمجة التطبيقات Play Integrity API بشكلٍ فردي. يتم تلقائيًا احتساب طلباتك إلى Play Integrity API ضمن استخدام حزمة SDK لواجهة برمجة التطبيقات وليس ضمن استخدام التطبيق.

يتوفّر لمطوّري حِزم SDK خياران لإعداد واجهة برمجة التطبيقات Play Integrity API، وهما Google Play SDK Console أو Google Cloud Console.

استخدام Google Play SDK Console (إجراء يُنصح به)

من خلال تفعيل الردود من واجهة برمجة التطبيقات Play Integrity API في Google Play SDK Console، يمكنك الوصول إلى خيارات ضبط إضافية. انتقِل إلى سلامة حزمة تطوير البرامج (SDK) وانقر على الإعدادات. ضمن إعدادات المشروع، اختَر ربط مشروع على السحابة الإلكترونية. اختَر مشروع Cloud الذي تريد ربطه بحزمة SDK، وسيؤدي ذلك إلى تفعيل الردود من واجهة برمجة التطبيقات Play Integrity API. يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في حزمة SDK. يُرجى العِلم أنّ الوصول إلى Google Play SDK Console يخضع لمعايير الأهلية.

استخدام Google Cloud Console

يمكنك تفعيل الردود من واجهة برمجة التطبيقات Play Integrity API من خلال Google Cloud Console. في Google Cloud Console، أنشِئ مشروعًا جديدًا على Cloud أو اختَر مشروعًا حاليًا على Cloud تريد استخدامه مع واجهة برمجة التطبيقات Play Integrity API. انتقِل إلى واجهات برمجة التطبيقات والخدمات. انقر على تفعيل واجهات برمجة التطبيقات والخدمات. ابحث عن واجهة برمجة التطبيقات Play Integrity API ثم فعِّلها. يمكنك الآن دمج واجهة برمجة التطبيقات Play Integrity API في حزمة SDK.

زيادة عدد الطلبات اليومية التي ترسلها حزمة SDK إلى واجهة برمجة التطبيقات Play Integrity API

على مقدّمي حِزم SDK الذين يريدون زيادة الحد الأقصى للطلبات اليومية إكمال نموذج طلب الحصة. في قسم التعليقات المفتوحة، حدِّد أنّك بصدد تقديم طلب للحصول على حزمة SDK وأدرِج إحداثيات Maven (groupId:artifactId) أو عنوان URL لحزمة SDK.

زيادة عدد الطلبات اليومية المُرسَلة إلى واجهة برمجة التطبيقات Play Integrity API

يخضع تطبيقك لعدد إجمالي لا يتجاوز 10,000 طلب في اليوم. يمكنك طلب زيادة هذا الحد الأقصى اليومي إذا كان تطبيقك يحتاج إلى التعامل مع عدد أكبر من المستخدمين باتّباع التعليمات أدناه.

زيادة الحد الأقصى لعدد الطلبات اليومية

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

لطلب زيادة الحد الأقصى لعدد الطلبات اليومية، اتّبِع الخطوات التالية:

1. ربط مشروع Google Cloud الذي تستخدمه مع واجهة برمجة التطبيقات Play Integrity API في Play Console
2. تأكَّد من تنفيذ منطق واجهة برمجة التطبيقات بشكلٍ صحيح، بما في ذلك استراتيجية إعادة المحاولة المقترَحة.
3. يمكنك طلب زيادة الحصة باستخدام هذا النموذج.

قد يستغرق زيادة حصة Play Integrity API مدة تصل إلى أسبوع، لذا ننصحك بشدة بمراقبة استخدامك لواجهة برمجة التطبيقات Play Integrity API في Google Play Console أو في Google Cloud Console، حيث يمكنك أيضًا إعداد تنبيهات الحصة، لتجنُّب انقطاع الخدمة.

سيتم تطبيق الزيادات في الحصة الكلاسيكية للطلبات تلقائيًا على كلّ من طلب العميل لإنشاء علامات السلامة وطلب الخادم لفك تشفير علامات السلامة والتحقّق منها. يتم تطبيق الزيادات في الحصة العادية للطلبات على طلب العميل لفك تشفير الرموز المميّزة للسلامة والتحقّق منها.

ملاحظة: يُعدّ اسم الحزمة نفسه على Google Play وقنوات التوزيع الأخرى تطبيقًا واحدًا من حيث استخدام واجهة برمجة التطبيقات. إذا كنت تستخدِم رقم تعريف مشروع واحدًا على Google Cloud لتطبيقات متعددة لها أسماء حِزم مختلفة، سيتم احتساب التطبيقات كتطبيق واحد من حيث استخدام واجهة برمجة التطبيقات.

دمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك

لدمج واجهة برمجة التطبيقات Play Integrity API في تطبيقك أو حزمة SDK، عليك تنفيذ أحد الإجراءين التاليين تبعًا لبيئات التطوير:

Kotlin أو Java

تتوفّر أحدث مكتبة Android لواجهة برمجة التطبيقات Play Integrity API من مستودع Maven من Google. أضِف التبعية التالية إلى ملف build.gradle في تطبيقك:

implementation 'com.google.android.play:integrity:1.4.0'

الوحدة

توضّح الأقسام التالية كيفية دمج واجهة برمجة التطبيقات Google Play Integrity API وإعدادها لمشاريع Unity، بما في ذلك إصدارات Unity المتوافقة، وطرق التثبيت، وإعداد البيئة.

إصدارات Unity المتوافقة

• تتوافق جميع الإصدارات ‎2019.x و‎2020.x والإصدارات الأحدث.
• إذا كنت تستخدم Unity 2018.x، يجب استخدام الإصدار 2018.4 أو إصدار أحدث.
• لا يتوفّر الإصدار Unity 2017.x والإصدارات الأقدم.

إعداد بيئة التطوير

OpenUPM-CLI

إذا كان لديك واجهة برمجة التطبيقات OpenUPM مثبّتة، يمكنك تثبيت قاعدة بيانات مسجّلي OpenUPM باستخدام الأمر التالي:

openupm add com.google.play.integrity

OpenUPM

1. افتح إعدادات مدير الحِزم من خلال اختيار خيار قائمة Unity تعديل > إعدادات المشروع > مدير الحِزم.

2. أضِف OpenUPM كقاعدة بيانات مسجّلين على مستوى النطاق إلى نافذة "مدير الحِزم":

   Name: package.openupm.com
   URL: https://package.openupm.com
   Scopes: com.google.external-dependency-manager
     com.google.play.common
     com.google.play.core
     com.google.play.integrity
   

3. افتح قائمة مدير الحِزم من خلال اختيار خيار قائمة Unity نافذة > مدير الحِزم.

4. اضبط القائمة المنسدلة لنطاق عمل المدير لاختيار سجلّاتي.

5. اختَر حزمة Google Play Integrity plugin for Unity من قائمة الحِزم واضغط على تثبيت.

الاستيراد من GitHub

1. نزِّل أحدث إصدار من .unitypackage من GitHub.

2. استورِد ملف .unitypackage من خلال اختيار خيار قائمة Unity التالي: مواد العرض > استيراد حزمة > حزمة مخصّصة واستيراد جميع العناصر.

ملاحظة: يعني تنزيل "مكوّنات Google Play Unity" واستخدامها موافقتك على بنود خدمة حزمة تطوير البرامج Play Core.

Unreal Engine

توضّح الأقسام التالية كيفية دمج واجهة برمجة التطبيقات Google Play Integrity API وإعدادها لمشاريع Unreal Engine.

إصدارات Unreal Engine المتوافقة

يتوافق المكوّن الإضافي مع Unreal Engine 5.0 وجميع الإصدارات اللاحقة.

إعداد بيئة التطوير

ملاحظة: إذا سبق لك استخدام المكوّنات الإضافية "المراجعات داخل التطبيق" أو "التحديثات داخل التطبيق" في IDE IDE Unreal Engine، يمكنك التخطّي إلى الخطوة الأخيرة.

1. نزِّل مكوّن Play Unreal Engine الإضافي من مستودع GitHub.

2. انسخ مجلد GooglePlay داخل مجلد Plugins في مشروع Unreal Engine.

3. افتح مشروع Unreal Engine وانقر على تعديل (Edit) → الإضافات (Plugins).

4. ابحث عن Google Play وضَع علامة في مربّع الاختيار مفعَّل.

5. أعِد تشغيل مشروع اللعبة وأطلِق عملية إنشاء.

6. افتح ملف Build.cs في مشروعك وأضِف وحدة PlayIntegrity إلى PublicDependencyModuleNames:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayIntegrity");
   
       // ...
     }
   }
   

مدمجة مع المحتوى

ثبِّت الإصدار 1.13.0 أو إصدار أحدث من حزمة تطوير البرامج (SDK) Play Core Native. للحصول على التعليمات، يُرجى الاطّلاع على دليل إعداد بيئة التطوير في Play Core Native.

ضبط الردود من واجهة برمجة التطبيقات (اختياري)

يتضمّن ردّ واجهة برمجة التطبيقات النتائج التلقائية التي يتم عرضها في كل طلب. إذا أعددت دمج واجهة برمجة التطبيقات Play Integrity API في Play Console، يمكنك تخصيص ردّ واجهة برمجة التطبيقات.

الردود التلقائية

يتم تلقائيًا عرض بيانات السلامة التالية في ردّ واجهة برمجة التطبيقات Play Integrity API:

حقل الردّ	القيمة	الوصف
سلامة الجهاز	MEETS_DEVICE_INTEGRITY	يعمل التطبيق على جهاز Android متوافق مع "خدمات Google Play". يجتاز الجهاز عمليات التأكّد من سلامة النظام ويفي بمتطلّبات التوافق مع نظام التشغيل Android.
	فارغ (قيمة فارغة)	يعمل التطبيق على جهاز يتضمّن علامات تشير إلى تعرُّضه للهجوم (مثل التلاعب بواجهة برمجة التطبيقات) أو تعرُّض النظام للاختراق (مثل تزويده بإذن الوصول إلى الجذر)، أو لا يعمل التطبيق على جهاز فعلي (مثل جهاز محاكاة لا يجتاز عمليات التحقّق من السلامة في Google Play).
تفاصيل حساب Play	LICENSED	يملك المستخدِم إذن الوصول إلى التطبيق. بعبارة أخرى، ثبَّت المستخدم تطبيقك أو عدّله من Google Play على جهازه.
	UNLICENSED	لا يملك المستخدِم إذنًا للوصول إلى التطبيق. ويحدث ذلك مثلاً في حال ثبَّت المستخدم تطبيقك من مصدر غير معروف أو لم يحصل عليه من Google Play.
	UNEVALUATED	لم يتم تقييم تفاصيل الترخيص بسبب عدم استيفاء أحد المتطلبات. وقد يحدث ذلك لعدة أسباب، بما في ذلك ما يلي: الجهاز غير موثوق بالقدر الكافي لم يسجِّل المستخدم الدخول إلى Google Play. لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز
سلامة التطبيق	PLAY_RECOGNIZED	يتطابق التطبيق وشهادة التطبيق مع الإصدارات التي تم توزيعها من خلال Google Play.
	UNRECOGNIZED_VERSION	لا تتطابق شهادة التطبيق أو اسم حزمة التطبيق مع سجلّات Google Play
	UNEVALUATED	لم يتم تقييم سلامة التطبيق. ولم يتم استيفاء أحد المتطلّبات الضرورية، مثلاً أن يكون الجهاز غير موثوق بالقدر الكافي.

الردود الشَرطية

في حال التوزيع على ألعاب Google Play على الكمبيوتر، سيتم تلقائيًا تفعيل ميزة تلقّي تصنيف إضافي في نتيجة سلامة الجهاز:

حقل الردّ	التصنيف	الوصف
سلامة الجهاز	MEETS_VIRTUAL_INTEGRITY	يعمل التطبيق على محاكي Android متوافق مع "خدمات Google Play". يجتاز المحاكي عمليات التحقّق من سلامة النظام ويستوفي متطلبات التوافق الأساسية مع نظام التشغيل Android.

الردود الاختيارية

في حال إعداد عملية دمج واجهة برمجة التطبيقات Play Integrity API في Play Console أو Play SDK Console، يمكنك تفعيل تلقّي المعلومات في ردّ واجهة برمجة التطبيقات.

لإجراء تغييرات على ردود واجهة برمجة التطبيقات، انتقِل إلى Play Console وانتقِل إلى الإصدار > سلامة التطبيق. ضمن الردود، عدِّل التغييرات واحفظها.

تحذير: تسري التغييرات على استجابات سلامة الجهاز على الفور، بما في ذلك عندما يكون تطبيقك قيد الإصدار العلني. قبل تغيير مجموعة رسائل تأكيد سلامة الجهاز في Play Console، تأكَّد من أنّه قد تم إعداد الخادم لقبول هذه الرسائل.

معلومات الجهاز الاختيارية

يمكن للتطبيقات وحِزم تطوير البرامج (SDK) تفعيل تصنيفات الأجهزة الإضافية في نتيجة سلامة الجهاز. بعد تفعيل تلقّي تصنيفات إضافية، سيتضمّن استجابة السلامة تصنيفات متعددة للجهاز نفسه في حال استيفاء كلّ من معايير التصنيف. يمكنك إعداد خادم الخلفية ليتصرف بشكل مختلف استنادًا إلى نطاق الردود المحتملة. على سبيل المثال، يمكن الوثوق بالجهاز الذي يعرض ثلاثة تصنيفات (MEETS_STRONG_INTEGRITY وMEETS_DEVICE_INTEGRITY وMEETS_BASIC_INTEGRITY ) أكثر من الجهاز الذي يعرض تصنيفًا واحدًا فقط (MEETS_BASIC_INTEGRITY).

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

يمكنك أيضًا تفعيل سمات الجهاز التي تُعلمك بالإصدار لحزمة تطوير البرامج (SDK) لنظام التشغيل Android المُستخدَم على الجهاز. وقد تتم في المستقبل إضافة سمات أخرى للأجهزة.

حقل الردّ	التصنيف	الوصف
سلامة الجهاز	MEETS_BASIC_INTEGRITY	يعمل التطبيق على جهاز يجتاز عمليات التأكّد الأساسية من سلامة النظام، ويتطلّب أجهزة Android 13 والإصدارات الأحدث مصادقة مفتاح نظام Android الأساسي. قد لا يستوفي الجهاز متطلّبات التوافق مع نظام Android، وقد لا يحصل على موافقة لتفعيل "خدمات Google Play". على سبيل المثال، قد يعمل الجهاز بإصدار غير معروف من Android، أو قد يكون مزوّدًا بوظيفة bootloader غير مقفلة أو قد لا يكون قد حصل على اعتماد من الشركة المصنّعة.
	MEETS_STRONG_INTEGRITY	يعمل التطبيق على جهاز Android متوافق مع "خدمات Google Play"، ويضمن استيفاء النظام للمتطلبات المشدّدة للسلامة، مثل إثبات سلامة عملية التمهيد المستند إلى الأجهزة، ويتطلّب أجهزة Android 13 والإصدارات الأحدث توفُّر تحديث أمان خلال العام الماضي. يجتاز الجهاز عمليات التأكّد من سلامة النظام ويفي بمتطلّبات التوافق مع نظام التشغيل Android.
		طلبات الرموز المميزة العادية لسلامة واجهة برمجة التطبيقات على هذا الجهاز في آخر ساعة لكل تطبيق	طلبات الرموز المميّزة الكلاسيكية لسلامة واجهة برمجة التطبيقات على هذا الجهاز في آخر ساعة لكل تطبيق
أحدث نشاط للجهاز	LEVEL_1 (أدنى)	10 أو أقل	5 أو أقل
	LEVEL_2	بين 11 و25	بين 6 و10
	LEVEL_3	بين 26 و50	بين 11 و15
	LEVEL_4 (أعلى)	أكثر من 50	أكثر من 15
	UNEVALUATED	لم يتم تقييم أحدث نشاط للجهاز. قد يعود سبب حدوث ذلك إلى: الجهاز غير موثوق بالقدر الكافي لا يتعرّف Google Play على إصدار تطبيقك المثبّت على الجهاز. حدثت مشاكل فنية على الجهاز.
سمات الجهاز	sdkVersion: 19, 20, ..., 35	إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android الذي يعمل على الجهاز يتم ربط الرقم المعروض برمز Build.VERSION_CODES.
	فارغ (قيمة فارغة)	لا يتم تقييم إصدار حزمة تطوير البرامج (SDK) بسبب عدم استيفاء أحد المتطلبات اللازمة. في هذه الحالة، يكون الحقل sdkVersion غير محدّد، وبالتالي يكون الحقل deviceAttributes فارغًا. قد يرجع ذلك إلى: الجهاز غير موثوق بالقدر الكافي لا يتعرّف Google Play على إصدار تطبيقك المثبّت على الجهاز. حدثت مشاكل فنية على الجهاز.

تفاصيل السياق الاختيارية

يمكن للتطبيقات تفعيل ميزة تلقّي أحكام إضافية حول البيئة. تتيح لك ميزة احتمالية الوصول إلى التطبيق معرفة ما إذا كانت هناك تطبيقات أخرى قيد التشغيل يمكنها التقاط الشاشة أو عرض عناصر مركّبة أو التحكّم في الجهاز. يتيح لك بيان Play للحماية معرفة ما إذا كانت خدمة Play للحماية مفعَّلة على الجهاز وما إذا كانت قد عثرت على برامج ضارة معروفة.

بعد الموافقة على تلقّي هذه الأحكام، سيتضمّن ردّ واجهة برمجة التطبيقات حقل تفاصيل البيئة مع الحكم:

حقل الردّ	القيمة	الوصف
بيان خطورة الوصول إلى التطبيق	KNOWN_INSTALLED	يتم تثبيت التطبيقات من خلال Google Play أو يتم تحميلها مسبقًا على قسم النظام من قِبل الشركة المصنّعة للجهاز.
	KNOWN_CAPTURING	يتم تشغيل التطبيقات التي ثبَّتها Google Play أو تم تحميلها مسبقًا على الجهاز والتي يمكن استخدامها لقراءة مدخلات التطبيق المُرسِل للطلب أو تسجيلها، مثل تطبيقات تسجيل الشاشة.
	KNOWN_CONTROLLING	التطبيقات المثبَّتة من خلال Google Play أو المحمَّلة مسبقًا على الجهاز والتي يمكن استخدامها للتحكّم في الجهاز وعمليات الإدخال والإخراج للتطبيق الذي يطلب الإذن، مثل تطبيقات التحكّم عن بُعد
	KNOWN_OVERLAYS	التطبيقات المثبّتة من خلال Google Play أو المحمَّلة مسبقًا على الجهاز والتي قد تعرض عناصر مركّبة على التطبيق الذي يطلب الإذن
	UNKNOWN_INSTALLED	تم تثبيت تطبيقات أخرى لم يتم تثبيتها من خلال Google Play أو تم تحميلها مسبقًا على قسم النظام من قِبل الشركة المصنّعة للجهاز.
	UNKNOWN_CAPTURING	يتم تشغيل تطبيقات أخرى (لم يتم تثبيتها من خلال Play أو تحميلها مسبقًا على الجهاز) يمكن استخدامها لقراءة مدخلات التطبيق المُرسِل أو تسجيلها أو إخراجها، مثل تطبيقات تسجيل الشاشة.
	UNKNOWN_CONTROLLING	يتم تشغيل تطبيقات أخرى (لم يتم تثبيتها من خلال Play أو تحميلها مسبقًا على الجهاز) يمكن استخدامها للتحكّم في الجهاز وعمليات الإدخال والإخراج للتطبيق الذي يطلب الإذن، مثل تطبيقات التحكّم عن بُعد.
	UNKNOWN_OVERLAYS	يتم تشغيل تطبيقات أخرى (لم يتم تثبيتها من خلال Play أو تم تحميلها مسبقًا على الجهاز) قد تعرض رسومًا توضيحية على التطبيق الذي يطلب الإذن.
	فارغ (قيمة فارغة)	لا يتم تقييم احتمالية اختراق التطبيق في حال عدم استيفاء شرط ضروري. في هذه الحالة، يكون حقل appAccessRiskVerdict فارغًا. وقد يحدث ذلك لعدة أسباب، بما في ذلك: الجهاز غير موثوق بالقدر الكافي شكل الجهاز ليس هاتفًا أو جهازًا لوحيًا أو جهازًا قابلاً للطي. الجهاز لا يعمل بالإصدار 6 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) أو إصدار أحدث. لا يتعرّف Google Play على إصدار التطبيق المثبّت على الجهاز إصدار "متجر Google Play" على الجهاز قديم. الألعاب فقط: لا يملك حساب المستخدم ترخيصًا على Play للّعبة. تم استخدام طلب عادي مع المَعلمة verdictOptOut. تم استخدام طلب عادي مع إصدار مكتبة Play Integrity API لا يتيح بعد تقييم مستوى خطورة الوصول إلى التطبيق للطلبات العادية.
نتيجة فحص "Play للحماية"	NO_ISSUES	تم تفعيل خدمة "Play للحماية" ولم تعثر على أي مشاكل في التطبيقات على الجهاز.
	NO_DATA	تم تفعيل خدمة "Play للحماية" ولكن لم يتم إجراء أي فحص بعد. قد تكون تمت إعادة ضبط الجهاز أو تطبيق "متجر Play" مؤخرًا.
	POSSIBLE_RISK	خدمة "Play للحماية" غير مفعَّلة.
	MEDIUM_RISK	تم تفعيل خدمة "Play للحماية" وعثرت على تطبيقات قد تتسبّب بضرر على الجهاز.
	HIGH_RISK	خدمة "Play للحماية" مفعَّلة وعثرت على تطبيقات خطيرة تم تثبيتها على الجهاز.
	UNEVALUATED	لم يتم تقييم بيان "Play للحماية". ولم يتم استيفاء أحد المتطلّبات الضرورية، مثلاً أن يكون الجهاز غير موثوق بالقدر الكافي.

ملاحظة: التطبيقات التي تعرض استجابة تحكّم في بيان خطورة الوصول إلى التطبيق عندما يكون إذن تسهيل الاستخدام مفعّلاً فيها لدى المستخدمين الذين يعانون من عجز أسباب مشروعة لاستخدام ميزات تسهيل الاستخدام على الأجهزة، لذا تُستبعد تلقائيًا خدمات تسهيل الاستخدام التي تم التحقّق منها والتي يعرفها Google Play من إرسال استجابة تشير إلى أنّها تلتقط الشاشة أو تتحكّم فيها أو تضيفها كطبقة.

ضبط إعدادات الطلبات الكلاسيكية (اختياري)

يمكنك تخطّي هذا القسم إذا كنت تخطّط لإجراء طلبات البيانات العادية من واجهة برمجة التطبيقات فقط.

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

السماح لشركة Google بإدارة تشفير الردود (الإعداد التلقائي والمُقترَح)

لحماية أمان تطبيقك، ننصحك بالسماح لشركة Google ب إنشاء مفاتيح تشفير الردود وإدارتها. وسيطلب الخادم الخلفي من خادم Google Play أن يفك تشفير الردود.

إدارة مفاتيحي الخاصة بتشفير الردود وتنزيلها

إذا أردت فك تشفير نتيجة السلامة محليًا ضمن بيئة خادم آمن، يمكنك إدارة مفاتيح تشفير الردود وتنزيلها. لإدارة مفاتيح تشفير الردود وتنزيلها، يجب استخدام Play Console، ويجب أن يكون تطبيقك متاحًا على Google Play بالإضافة إلى أي قنوات distribusion أخرى. اتّبِع التعليمات التالية للتبديل من مفاتيح تشفير الردود التي تديرها Google إلى مفاتيح تشفير الردود التي تديرها بنفسك.

تذكَّر عدم فك تشفير الرمز المميّز الذي تم تلقّيه أو التحقّق منه من داخل العميل التطبيق، ولا تُظهِر أبدًا أي مفاتيح فك تشفير لتطبيق العميل.

قبل تغيير استراتيجية إدارة تشفير الردود في Play Console، تأكَّد من أنّ خادمك قد تم إعداده بشكلٍ صحيح لفك تشفير علامات السلامة والتحقّق منها على خوادم Google Play لتجنُّب حدوث أي انقطاع.

ملاحظة: عند إدارة مفاتيح تشفير الردود وتنزيلها، يمكن لتطبيقك الرجوع إلى خوادم Google Play لفك تشفير الرد والتحقّق منه.

التبديل بين مفاتيح تشفير الردود التي تديرها Google والمفاتيح التي تديرها بنفسك

إذا كانت Google تدير حاليًا عملية تشفير الردود وأردت التبديل إلى إدارة مفاتيح تشفير الردود وتنزيلها بنفسك، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى Play Console.
2. اختَر تطبيقًا يستخدم واجهة برمجة التطبيقات Play Integrity API.
3. في قسم الإصدار من القائمة اليمنى، انتقِل إلى سلامة التطبيق.
4. بجانب واجهة برمجة التطبيقات Play Integrity API، انقر على الإعدادات.
5. في قسم الطلبات الكلاسيكية من الصفحة، انقر على تعديل بجانب تشفير الردّ.
6. في النافذة التي تظهر، انقر على إدارة وتنزيل مفاتيحي الخاصة بتشفير الردود.
7. اتّبِع التعليمات لتحميل مفتاح علني.
8. بعد أن تُظهر النافذة أنّ عملية التحميل قد تمت بنجاح، انقر على حفظ و سيتم تنزيل مفاتيحك المشفَّرة تلقائيًا.
9. غيِّر منطق الخادم لكي تتمكّن من فك تشفير الرموز المميّزة لسلامة البيانات والتحقّق منها محليًا، في بيئة الخادم الآمنة الخاصة بك، باستخدام مفاتيح تشفير الردود.
10. (اختياري) عند إدارة مفاتيح تشفير الردود بنفسك، يمكن لتطبيقك الرجوع إلى خادم Google Play لفك تشفير الرد والتحقّق منه.

إذا كنت تدير مفاتيح تشفير الردود بنفسك وأردت التبديل إلى أن تديرها Google، اتّبِع الخطوات التالية:

1. غيِّر منطق الخادم لكي تتمكّن من فك التشفير والتحقّق فقط على خوادم Google.
2. سجِّل الدخول إلى Play Console.
3. اختَر تطبيقًا يستخدم واجهة برمجة التطبيقات Play Integrity API.
4. في قسم الإصدار من القائمة اليمنى، انتقِل إلى سلامة التطبيق.
5. بجانب واجهة برمجة التطبيقات Play Integrity API، انقر على الإعدادات.
6. في قسم الطلبات الكلاسيكية من الصفحة، انقر على تعديل بجانب تشفير الردّ.
7. في النافذة التي تظهر، انقر على السماح لشركة Google بإدارة تشفير مفاتيحي الخاصة بتشفير الردود (خيار مُقترَح).
8. انقر على حفظ التغييرات.

ملاحظة مهمة: بعد إجراء التغيير في Play Console، لن تعمل أي مفاتيح تشفير للردّ سبق لك تنزيلها. يسري التغيير على الفور، حتى إذا كان تطبيقك قيد الإصدار العلني.