‫Play Integrity API: دليل ربط المشاريع على السحابة الإلكترونية والحصص

تفرض واجهة Google Play Integrity API حدًّا أقصى يبلغ 10,000 طلب يوميًا على الزيارات الواردة من مشاريع Google Cloud غير المرتبطة بتطبيق في Google Play Console أو بحزمة SDK في Play SDK Console. هذا الحدّ مفعّل حاليًا لمعظم مشاريع Google Cloud. تم منح عدد صغير من المشاريع التي لديها حصة مرتفعة مسبقًا مهلة ممتدة حتى 16 فبراير 2027 لإكمال عملية الربط قبل تطبيق الحدّ الأقصى.

يوضّح هذا الدليل تأثير ربط المشاريع في حصتك، وكيفية ربط مشاريعك على Google Cloud بتطبيقك أو حزمة تطوير البرامج (SDK)، ويجيب عن الأسئلة الشائعة.

ملخّص سريع

تفاصيل أساسية الوصف
تاريخ التنفيذ مفعَّلة حاليًا لمعظم المشاريع.
‫16 فبراير 2027 للمشاريع التي تلقّت إشعارًا بالموعد النهائي
السياسة يبلغ الحدّ الأقصى لطلبات Play Integrity API الواردة من مشاريع على السحابة الإلكترونية غير مرتبطة بتطبيقك أو حزمة تطوير البرامج (SDK) 10,000 طلب بيانات من واجهة برمجة التطبيقات في اليوم، بغض النظر عن أيّ حصة مخصّصة أعلى تم ضبطها في المشروع.
المستخدمون المتأثرون التطبيقات وحزم SDK التي تُرسل أكثر من 10,000 طلب يوميًا باستخدام مشروع على Google Cloud غير مرتبط بهذا التطبيق (في Play Console) أو بحزمة SDK (في Play SDK Console).
يجب اتخاذ إجراء اربط مشاريعك على Google Cloud بتطبيقك في Google Play Console أو بحزمة SDK في Google Play SDK Console.
خطأ في تجاوز الحصة المخصّصة تتعذّر الطلبات غير المرتبطة التي تتجاوز 10,000 طلب في اليوم مع ظهور الخطأ TOO_MANY_REQUESTS (رمز الخطأ -8).

الأسئلة الشائعة

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

لحماية تطبيقك أو حزمة تطوير البرامج (SDK) ومنع الجهات الخارجية غير المصرَّح لها من استنفاد حصتك، تقتصر الحصة اليومية المتزايدة حصريًا على مشاريع Google Cloud المرتبطة بتطبيقك في Google Play Console أو بحزمة SDK في Google Play SDK Console.

بالنسبة إلى التطبيقات (Google Play Console):

  1. سجِّل الدخول إلى Google Play Console واختَر تطبيقك.
  2. في قائمة التنقّل اليمنى، انتقِل إلى محمي من خلال Google Play.
  3. بجانب Play Integrity API، انقر على البدء (أو إدارة).
  4. انقر على ربط مشروع على السحابة الإلكترونية (أو إضافة مشروع إذا سبق لك ربط مشاريع).
  5. اختَر أو أدخِل رقم مشروع Google Cloud الذي تريد ربطه، ثم أكِّد اختيارك.

بالنسبة إلى حِزم SDK ‏ (Google Play SDK Console):

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

الأذونات المطلوبة:

  • ‫Play Console (للتطبيقات): يجب أن يكون لديك إذن "طرح التطبيق على قناة الإصدار العلني واستثناء الأجهزة واستخدام ميزة "توقيع التطبيق" من Play" للتطبيق.
  • ‫Play SDK Console (لحِزم SDK): يجب أن يكون لديك إذن "الإدارة" لحزمة SDK.
  • ‫Google Cloud (كلاهما): يجب أن يكون لديك الإذنان serviceusage.services.enable وresourcemanager.projects.get في مشروع Google Cloud المستهدَف.

بالنسبة إلى التطبيقات (Google Play Console):

  1. افتح Google Play Console > محمي من خلال Google Play > ‏Play Integrity API > إدارة.
  2. اطّلِع على قسم "إعدادات المشروع".
  3. يُرجى التأكّد من أنّ رقم المشروع المُدرَج يتطابق مع الرقم المستخدَم لاستدعاء Play Integrity API.

بالنسبة إلى حِزم SDK ‏ (Google Play SDK Console):

  1. افتح Google Play SDK Console > صحة بيانات حزمة تطوير البرامج (SDK) > الإعدادات.
  2. اطّلِع على قسم "إعدادات المشروع".
  3. يُرجى التأكّد من أنّ رقم المشروع المُدرَج يتطابق مع الرقم المستخدَم لاستدعاء Play Integrity API.

السؤال 4: كيف يمكنني ربط مشروعي على السحابة الإلكترونية إذا لم يكن تطبيقي أو حزمة SDK الخاصة بي متاحَين على Google Play؟

لا يتوفّر ربط مشروع على Google Cloud إلا للتطبيقات المُدارة في Google Play Console وحِزم SDK المسجَّلة في Google Play SDK Console.

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

س5: هل يمكنني ربط عدة مشاريع على Google Cloud، أو مشاركة مشروع واحد في تطبيقات أو حزم SDK؟

  • مشاريع متعدّدة لكل تطبيق أو حزمة تطوير برامج (SDK): يمكنك ربط ما يصل إلى خمسة مشاريع على Google Cloud بتطبيق واحد أو حزمة تطوير برامج (SDK) واحدة.
  • مشروع واحد في تطبيقات متعددة: يمكنك ربط مشروع Google Cloud نفسه بتطبيقات متعددة في Google Play Console. لا يمكن ربط مشروع على السحابة الإلكترونية نفسه بحِزم تطوير برامج (SDK) متعدّدة أو بحزمة تطوير برامج (SDK) وتطبيق.

السؤال 6: ماذا لو كنت أدير التطبيق أو حزمة تطوير البرامج (SDK)، ولكنّ شخصًا آخر في مؤسستي يملك مشروع Google Cloud؟

لإكمال عملية الربط، يجب أن يكون لدى المستخدم الذي ينفّذ الإجراء في Play Console (أو Play SDK Console) الأذونات المطلوبة أيضًا في مشروع Google Cloud. يمكنك تنسيق ذلك بإحدى طريقتَين:

  • الخيار "أ": اطلب من مستخدم يمكنه إدارة الوصول إلى "إدارة الهوية وإمكانية الوصول" في مشروع Google Cloud أن يمنح حسابك على Google مؤقتًا إذنَي serviceusage.services.enable وresourcemanager.projects.get. بعد الربط، لن تكون هذه الأذونات مطلوبة للعمليات اليومية.
  • الخيار "ب": منح أحد أعضاء الفريق الذي لديه الإذنَين serviceusage.services.enable وresourcemanager.projects.get في مشروع Google Cloud إذن Console المطلوب ليتمكّن من تنفيذ خطوة الربط:
    • بالنسبة إلى التطبيقات (Play Console): يجب منح إذن "طرح الإصدار على قناة الإصدار العلني، واستثناء الأجهزة، واستخدام ميزة "توقيع التطبيق" من Play" للتطبيق.
    • بالنسبة إلى حِزم SDK ‏ (Play SDK Console): يجب منح إذن "الإدارة" لحزمة SDK.

السؤال 7: ماذا يحدث إذا لم أربط مشروعي على السحابة الإلكترونية قبل 16 فبراير 2027؟

إذا أرسل تطبيق أو حزمة تطوير البرامج (SDK) طلبات بيانات من واجهة برمجة التطبيقات إلى Play Integrity API باستخدام مشروع على السحابة الإلكترونية على Google Cloud غير مرتبط بعد 16 فبراير 2027:

  1. ما يصل إلى 10,000 طلب في اليوم: يستمر إرسال الطلبات بنجاح كالمعتاد ضمن الحصة الأساسية التلقائية.
  2. أكثر من 10,000 طلب في اليوم: عندما يصل عدد الطلبات في المشروع غير المرتبط إلى 10,000 طلب في اليوم، يتم رفض الطلبات مع ظهور الخطأ TOO_MANY_REQUESTS (رمز الخطأ -8).

المعالجة الفورية من خلال الخدمة الذاتية:

إذا تلقّى تطبيقك أو حزمة SDK أخطاء من النوع TOO_MANY_REQUESTS بعد الموعد النهائي بسبب عدم ربط مشروع على السحابة الإلكترونية، فإنّ ربط مشروع Google Cloud غير المكتمل في Play Console أو Play SDK Console سيؤدي إلى حلّ المشكلة.

السؤال الثامن: لا أستخدم واجهة Play Integrity API. لماذا تلقّيتُ رسالة تطلب منّي ربط مشروعي على السحابة الإلكترونية؟

وصلك هذا الإشعار لأنّ مشروعك على Google Cloud يُنشئ أكثر من 10,000 طلب غير مرتبط في اليوم على Play Integrity API. تشمل الأسباب الشائعة ما يلي:

  1. مكتبة أو حزمة تطوير برامج (SDK) تم ضبطها باستخدام رقم مشروعك على السحابة الإلكترونية: تستدعي بعض المكتبات واجهة Play Integrity API باستخدام مشروعك على Google Cloud. إذا كان تطبيقك أو حزمة SDK يستخدمان هذه المكتبة، عليك ربط هذا المشروع بتطبيقك في Play Console أو بحزمة SDK في Play SDK Console.
  2. تطبيق أو فريق آخر في مؤسستك: قد يكون هناك فريق آخر يستخدم هذا المشروع على Google Cloud في تطبيقه أو حزمة SDK الخاصة به. يُرجى مراجعة الفِرق الهندسية لتحديد التطبيق أو حزمة SDK، ثم ربط المشروع في Play Console أو Play SDK Console.
  3. الزيارات غير المصرّح بها أو عمليات الدمج المتوقفة نهائيًا: إذا كانت التطبيقات غير المصرّح بها أو المستنسَخة ترسل طلبات باستخدام رقم مشروعك، أو إذا لم تعُد تستخدم واجهة برمجة التطبيقات، ليس عليك اتّخاذ أي إجراء. سيؤدي تطبيق الحد الأقصى البالغ 10,000 طلب يوميًا غير مرتبط إلى الحد من الزيارات غير المرغوب فيها.

التواصل والدعم

إذا كانت لديك أسئلة حول ربط مشروعك على السحابة الإلكترونية أو إدارة حصتك في Play Integrity API، يمكنك الاطّلاع على ما يلي: