إنشاء التطبيقات المرتبطة وإدارتها باستخدام AppFunctions وAndroid MCP في Google Connected Console

استخدِم Google Connected Console لدمج AppFunctions على جهازك في تطبيق Android مع Gemini على Android. من خلال إنشاء تطبيق مرتبط باستخدام نوع الربط Android MCP وربطه بتطبيقك على Google Play، يمكنك السماح لـ Gemini على Android بتنفيذ الإجراءات وإكمال المهام مباشرةً في تطبيقك نيابةً عن المستخدمين.

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

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

المتطلبات الأساسية

قبل البدء، تأكَّد من توفّر ما يلي:

• الوصول إلى حساب مطوّر مسجَّل في Google Connected Console:
  • الموافقة على بنود الخدمة: في المرة الأولى التي تصل فيها مؤسستك إلى "التطبيقات المرتبطة" في Google Connected Console، يجب أن يراجع صاحب الحساب أو المشرف بنود خدمة "التطبيقات المرتبطة" ويوافق عليها قبل أن يتمكّن أعضاء الفريق من إنشاء "تطبيقات مرتبطة".
  • أذونات المستخدمين: إذا تمت دعوتك إلى حساب مطوّر حالي على Connected Console ولكن لا يمكنك إنشاء تطبيقات متصلة، اطلب من صاحب الحساب أو المشرف منحك إذن عرض التطبيقات المتصلة أو إنشاء التطبيقات المتصلة وإدارتها في صفحة المستخدمون والأذونات. يجب أيضًا أن يكون لديك أذونات إدارة الإصدارات لتطبيقك المعنيّ على Google Play من أجل تحميل حِزم التطبيقات وإدارة الإصدارات.
• تطبيق حالي على Google Play في حسابك على Google Connected Console:
  • يجب أن يكون تطبيقك على Play موجودًا في حساب المطوّر نفسه لكي تتمكّن من ربطه بالتطبيق المرتبط. يمكن ربط كل تطبيق على Play بتطبيق واحد فقط مرتبط بمنصة MCP على Android.
  • تأكَّد من أنّ تطبيقك على Google Play يتضمّن بطاقة بيانات متجر تلقائية تم ضبطها باستخدام رمز التطبيق واللغات المتوافقة. تحدّد لغات بطاقة بيانات المتجر في تطبيق Google Play والبلدان المستهدَفة مدى توفّر تطبيقك المرتبط ببروتوكول MCP على Android.
• مجموعة حزمات تطبيق Android (.aab) تتضمّن AppFunctions:
  • اضبط حِزمة تطبيقك لاستهداف أجهزة Android الجوّالة، وهي المنصة المتوافقة مع دمج تطبيق Gemini على الجهاز فقط.
• فئة التطبيق المرتبط والبيانات الوصفية العلنية: جهِّز مواد العرض والتفاصيل التي تُشكّل حضور تطبيقك العلني:
  • فئة التطبيق المرتبط: تشير إلى النطاق أو فئة المجال لتطبيقك المرتبط. تحدّد كل فئة متطلبات الإمكانات الأساسية ولا يمكن تغييرها بعد الإنشاء.
  • اسم التطبيق: الاسم المعروض لتطبيقك المرتبط والذي يظهر للمستخدمين في جميع منتجات Google، ويُستخدم عندما يشير المستخدمون إلى تطبيقك باستخدام @ في Gemini.
  • رمز التطبيق المرتبط: رمز تطبيق بأبعاد 512 × 512 بكسل بتنسيق JPEG أو PNG، وبحدّ أقصى لحجم الملف يبلغ 1 ميغابايت (1,024 كيلوبايت).
  • وصف التطبيق: ملخّص موجز يوضّح للمستخدمين ما يمكن لتطبيقك المرتبط تنفيذه.
  • إمكانات التطبيق: يجب إضافة ثلاث إمكانات مخصّصة على الأقل توضّح للمستخدمين ما يمكن لتطبيقك فعله عند اتخاذ قرار بشأن ربطه، بالإضافة إلى أي إمكانات تلقائية تحدّدها فئة تطبيقك.
  • أمثلة على الطلبات: يجب تقديم ثلاثة أمثلة على الأقل على الطلبات التي توضّح للمستخدمين كيفية استدعاء تطبيقك في Gemini، وتساعدهم في فهم ما يمكنهم طلبه.
  • عنوان URL للسياسة: عنوان URL متاح للجميع يؤدي إلى سياسة الخصوصية.
  • عنوان URL لبنود الخدمة: عنوان URL متاح للجميع يؤدي إلى بنود الخدمة.
  • عنوان URL للموقع الإلكتروني (اختياري): عنوان URL متاح للجميع يشير إلى موقعك الإلكتروني لتحديد المصدر.

تسجيل AppFunctions واختبارها ونشرها باستخدام Gemini

بعد استيفاء المتطلبات الأساسية، أكمِل الخطوات التالية لتسجيل تطبيقك المرتبط ببروتوكول سياق النموذج (MCP) على Android، وربط تطبيقك على Google Play، وتعبئة تفاصيل تطبيقك، وتحميل AppFunctions وإرسالها، واختبارها على الجهاز فقط، ونشر التطبيق على قناة الإصدار العلني.

الخطوة 1: إنشاء تطبيق متصل بمنصة MCP على Android وربطه بتطبيقك على Google Play

لإنشاء تطبيق مرتبط وربطه بتطبيقك على Google Play، يُرجى اتّباع الخطوات التالية:

1. سجِّل الدخول إلى Google Connected Console.
2. في الصفحة الرئيسية، انقر على إنشاء تطبيق.
3. في مربّع الحوار اختيار ما تريد إنشاءه:
   • إذا طُلب منك قبول "بنود خدمة ربط التطبيقات"، انقر على عرض البنود، وراجِع الاتفاقية واقبلها، ثم انقر على إنشاء. يمكن فقط لمشرف الحساب قبول الاتفاقية.
   • بخلاف ذلك، انقر على إنشاء في بطاقة التطبيق المرتبط.
4. في مربّع الحوار يجب اختيار اسم لتطبيقك المرتبط، اكتب اسمًا لتطبيقك المرتبط. هذا هو الاسم الذي يعرض تطبيقك المرتبط في جميع منتجات Google، وهو الطريقة التي يشير بها المستخدمون إلى تطبيقك المرتبط باستخدام @. انقر على التالي.

5. في مربّع الحوار اختيار فئة تطبيق مرتبط، اختَر نطاق تطبيقك أو فئته أو مجاله من قائمة اختيار فئة.

   ملاحظة: تحدّد فئة التطبيق المرتبط متطلبات الإمكانات الأساسية ولا يمكن تغييرها لاحقًا. لاستخدام فئة مختلفة لاحقًا، عليك إنشاء تطبيق مرتبط جديد.

6. في مربّع الحوار اختيار نوع الربط، اختَر Android MCP.

   للحصول على شرح تفصيلي حول إعداد تطبيق مرتبط بخادم MCP، يُرجى الاطّلاع على دليل التكامل مع Google Play Console. في الوقت الحالي، يمكنك اختيار نوع اتصال واحد فقط لكل تطبيق مرتبط، ولا يمكنك تغييره لاحقًا.

7. انقر على إنشاء تطبيق مرتبط.

8. في مربّع الحوار اختيار تطبيق، ابحث عن تطبيق Play الذي يحتوي (أو سيحتوي) على AppFunctions، واختَره. يمكنك فلترة القائمة باستخدام البحث.

   • لا يمكن اختيار تطبيقات Google Play التي سبق ربطها بتطبيق مرتبط آخر.
   • تأكَّد من اختيار تطبيق Play الصحيح الذي تريد ربطه. بعد اختيار تطبيق على Play، لا يمكن تغييره.

سيؤدي ذلك إلى فتح صفحة النظرة العامة على إدارة تطبيقك المرتبط، حيث يمكنك مواصلة ضبط تفاصيل تطبيقك المرتبط وتتبُّع إصداراته وإدارة المختبِرين.

الخطوة 2: تقديم تفاصيل التطبيق المرتبط

قبل تحميل أي حِزم تطبيقات تحتوي على AppFunctions، عليك ضبط كيفية ظهور تطبيقك المرتبط للمستخدمين في Gemini.

ملاحظة مُهمّة: يجب ملء تفاصيل التطبيق المرتبط وحفظها قبل تحميل حزمة تطبيق تحتوي على AppFunctions. لا تنشئ Google Connected Console إصدار Android MCP من حزمة تطبيق تم تحميلها إلا بعد تقديم تفاصيل التطبيق المرتبط المطلوبة. إذا حمّلت حزمة تطبيقك قبل تقديم هذه التفاصيل، يُرجى إكمال تفاصيل التطبيق أولاً، ثم حذف حزمة تطبيقك وإعادة تحميلها أو تحميل حزمة تطبيق جديدة برمز إصدار أعلى.

اتّبِع الخطوات التالية لتقديم تفاصيل تطبيقك المرتبط:

1. في صفحة إدارة التطبيق المرتبط، ضِمن بطاقة MCP لنظام التشغيل Android، اختَر إضافة تفاصيل التطبيق (أو إدارة في حال تعديل التفاصيل الحالية) ضِمن إضافة تفاصيل التطبيق المرتبط.
2. في أعلى صفحة تفاصيل التطبيق، تحقَّق من حقل اسم التطبيق المرتبط. يمكنك تعديل الاسم إذا لزم الأمر. يظهر هذا الاسم للمستخدمين في جميع منتجات Google، ويُستخدم عندما يشير المستخدمون إلى تطبيقك باستخدام @.
3. في قسم التفاصيل العامة، ضمن الرمز، حمِّل رمز تطبيقك (بتنسيق JPG أو PNG، وبحجم لا يزيد عن 1 ميغابايت، وبأبعاد 512 × 512 بكسل).

4. أكمِل الحقول التالية:

   • الوصف: أدخِل ملخّصًا موجزًا من جملة واحدة (أقل من 30 كلمة) يصف الميزات الرئيسية لتطبيقك المرتبط ووظائفه. يظهر هذا النص للمستخدمين، ولا يُستخدم كتعليمات للنموذج.
   • الإمكانات: أدخِل ثلاث مهام على الأقل ذات قيمة عالية يمكن لتطبيقك المرتبط تنفيذها. انقر على إضافة إمكانية لإضافة المزيد من الإدخالات. لا تدرِج أرقامًا في بداية إمكاناتك. يجب تضمين إمكانية واحدة فقط لكل إدخال. إذا كانت فئة تطبيقك المرتبط تتضمّن إمكانات محدّدة مسبقًا، ستظهر في أعلى القائمة ولا يمكن تعديلها.
   • أمثلة على الطلبات: أدخِل ثلاثة أمثلة على الأقل للطلبات التي تساعد المستخدمين في فهم ما يمكنهم طلبه. انقر على إضافة مثال لطلب لإضافة إدخالات.
     • ابدأ طلبَين على الأقل بـ @<YourAppName> (على سبيل المثال، @Order Tracker where is my last order?).
     • يُرجى الإشارة إلى "<YourAppName>" بشكل طبيعي في طلب واحد على الأقل بدون البدء باسم تطبيقك (على سبيل المثال، Track my recent order on Order Tracker).
     • لا تُدرِج بادئات مرقّمة (1. أو 2. أو 3.) أو تضع الطلبات بين علامات اقتباس ("...").

   • الأقلمة بلغات متعددة: لتقديم ترجمات للوصف والإمكانات وأمثلة على الطلبات، يجب تضمين نص كل لغة في علامات اللغة داخل حقل الإدخال. على سبيل المثال:

     <en-US>
     Play music, manage playlists, and discover artists
     </en-US>
     <es-ES>
     Reproduce música, gestiona listas y descubre artistas
     </es-ES>
     

     تتحقّق Connected Console تلقائيًا من علاماتك وتعرض اللغات التي تم رصدها ضمن كل حقل (على سبيل المثال، Found translations for 2 languages: en-US, es-ES).

   • عنوان URL لبنود الخدمة: أدخِل رابطًا صالحًا يبدأ بـ https:// أو http:// يؤدي إلى بنود الخدمة.

   • عنوان URL لسياسة الخصوصية: أدخِل رابطًا صالحًا لبروتوكول https:// أو http:// يؤدي إلى سياسة الخصوصية.

   • عنوان URL للموقع الإلكتروني (اختياري): أدخِل رابطًا يؤدي إلى موقعك الإلكتروني لأغراض تحديد المصدر.

الخطوة 3: تحميل حزمة تطبيق تتضمّن AppFunctions وإرسال تطبيقك المرتبط

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

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

1. في صفحة إدارة التطبيق المرتبط، ضمن بطاقة Android MCP، انقر على تحميل حزمة تطبيق تحتوي على AppFunctions، ثم انقر على تحميل حزمة تطبيق للانتقال إلى نظرة عامة على الاختبار والإصدار في تطبيق Play المرتبط.
2. بدلاً من ذلك، يمكنك فتح تطبيق Play المرتبط مباشرةً في Google Connected Console. في قائمة التنقّل اليمنى لتطبيقك على Play، انتقِل إلى الاختبار > الاختبار الداخلي (أو مسار اختبار آخر) واختَر إنشاء إصدار جديد (أو تعديل الإصدار إذا كان لديك إصدار تمهيدي).
3. ضمن حِزم التطبيقات، انقر على تحميل لتحميل حزمة .aab التي تتضمّن AppFunctions، أو انقر على إضافة من المكتبة إذا حمّلت الحزمة بعد إكمال الخطوة 2.
4. بعد انتهاء عملية التحميل، انتقِل إلى قسم تم رصد وظائف التطبيق في حزمة تطبيقك في صفحة الإصدار. تأكَّد من ظهور اسم التطبيق المرتبط ورمز إصدار الحزمة وعدد الأدوات التي تم رصدها وعدد اللغات واستهداف البلدان في تطبيق Play على النحو المتوقّع، وتأكَّد من أنّ عمليات الفحص الآلي لا تُبلغ عن أي مشاكل. (إذا ظهرت أي أخطاء في عملية التحقّق، اتّبِع التعليمات الواردة في مقالة تحديد المشاكل وحلّها في ما يتعلّق بـ AppFunctions قبل المتابعة).
5. في أسفل صفحة الإصدار، انقر على إرسال التطبيق المرتبط والمتابعة.

يؤدي اختيار إرسال التطبيق المرتبط والمتابعة إلى إرسال إصدار AppFunctions إلى Gemini لإجراء اختبار المعاينة، وينقل إصدار Play إلى صفحة معاينة الإصدار. إذا أردت تكرار AppFunctions باستخدام الإصدارات المحلية بدون زيادة رمز إصدار حزمة تطبيقك، اترك إصدار Play في حالة "مسودة" ولا تختَر حفظ ونشر. يؤدي نشر إصدار على Google Play إلى قفل رمز إصدار الحزمة، وبالتالي لا يمكن حذفه وإعادة تحميله. وتتطلّب أي تغييرات لاحقة رمز إصدار أعلى لحزمة التطبيق. (إذا كان المختبِرون يثبّتون التطبيق مباشرةً من مسار الاختبار الداخلي في Google Play بدلاً من التثبيت من مصدر غير معروف، يُرجى إكمال عملية طرح الإصدار للاختبار الداخلي وزيادة رمز الإصدار في عمليات التحميل المستقبلية).

الخطوة 4: التحقّق من إصدار التطبيق المرتبط

بعد إرسال تطبيقك المرتبط من صفحة الإصدار في Play، تأكَّد من أنّ إصدار التطبيق المرتبط جاهز للمعاينة:

1. في صفحة إدارة التطبيق المرتبط، انقر على عرض بجانب الإصدارات في بطاقة Android MCP.
2. في صفحة الإصدارات، تأكَّد من ظهور الإصدار الذي أرسلته في قسم متاح للمختبِرين (يعرض Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
   • انقر على عرض في أي صف إصدار لفحص AppFunctions التي تم رصدها ولقطة تفاصيل التطبيق للقراءة فقط التي تم التقاطها لهذا الإصدار.
   • تظهر الإصدارات التي تم إنشاؤها من حزمة تطبيق تم تحميلها ولم يتم فيها بعد اختيار إرسال التطبيق المرتبط والمتابعة ضمن في انتظار الإرسال.

الخطوة 5: اختبار تطبيقك المرتبط

لإتاحة تطبيقك المرتبط للمختبِرين، يجب إضافتهم في صفحة إدارة المختبِرين. يمكن فقط للمستخدمين المُدرَجين في قائمة المختبِرين الاطّلاع على تطبيقك المرتبط غير المنشور والتفاعل معه. يمكنك فقط إضافة مختبِرين لديهم حساب @gmail.com.

1. في صفحة النظرة العامة على تطبيقك المرتبط، ضمن بطاقة اختبار تطبيقك، انقر على إضافة مختبِرين (أو إدارة المختبِرين إذا سبق لك إضافة بعضهم).
2. في صفحة إدارة المختبِرين، اختَر قوائم عناوين البريد الإلكتروني الحالية أو انقر على إنشاء قائمة عناوين بريد إلكتروني لإضافة حسابات Google المعتمَدة لاختبار عملية الدمج. تأكَّد من تضمين عنوان بريدك الإلكتروني إذا أردت اختبار التطبيق بنفسك.

3. انقر على حفظ.

   ملاحظة: بعد إضافة المختبِرين، قد يستغرق ظهور تطبيقك المرتبط لهذه الحسابات مدة تصل إلى 10 دقائق.

4. يمكن للمختبِرين في تطبيق Gemini استدعاء تطبيقك المرتبط من خلال كتابة @ متبوعًا باسم تطبيقك المرتبط واختياره من القائمة. يمكنك أيضًا الاطّلاع على تطبيقك وربطه في Gemini من خلال الانتقال إلى الإعدادات والمساعدة > التطبيقات المرتبطة في شريط التنقّل الأيمن.

قبل إجراء الاختبار على الجهاز، تأكَّد من أنّ كل مختبِر يستوفي المتطلبات التالية:

• تسجيل الدخول على هاتف جوّال أو جهاز لوحي يعمل بنظام التشغيل Android باستخدام حساب Google مُدرَج في قائمة عناوين البريد الإلكتروني التي تم ضبطها في الخطوة 5
• تشغيل إصدار تطبيق Android نفسه الذي يتطابق رمز إصدار حزمته مع الإصدار الذي تم إرساله في الخطوة 4

ننصحك باختبار عملية الدمج بدقة:

• جرِّب جميع أمثلة الطلبات.
• اختبِر كلاً من طلبات الاستدعاء الصريحة لـ "@<AppName>" وطلبات البحث باللغة الطبيعية.
• يجب التحقّق من معالجة مَعلمات الأدوات، وطلبات التأكيد، والتنفيذ الشامل في جميع دوال AppFunctions.

ملاحظة: يمكنك أيضًا تصحيح أخطاء تطبيقك المرتبط في "وضع مطور البرامج" في Gemini، حيث يمكنك اختبار خادم "بروتوكول سياق النموذج" (MCP) بشكل تفاعلي، وتشخيص أخطاء المخطط أو أخطاء أثناء التشغيل، وتقييم جودة الأداة قبل إرسال تطبيقك المرتبط للمراجعة في Google Connected Console. تأكَّد من تسجيل الدخول إلى Gemini باستخدام حساب.

عندما تكون راضيًا عن الاختبار، ستكون جاهزًا لإرسال تطبيقك المرتبط إلى Google لمراجعته.

الخطوة 6: نشر التطبيق المرتبط للمستخدمين

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

بعد الانتهاء من الاختبار والاستعداد لإطلاق التطبيق للمستخدمين:

1. في Google Connected Console، افتح تطبيق Play المرتبط وانتقِل إلى الإصدار > مرحلة الإنتاج في قائمة التنقّل اليمنى (أو يمكنك ترقية الإصدار الذي تم اختباره من مسار اختبار إلى مرحلة الإنتاج).
2. اختَر إنشاء إصدار جديد (أو عدِّل إصدارًا نهائيًا حاليًا في مرحلة المسودة) وأضِف حزمة التطبيق التي تتضمّن AppFunctions التي تم التحقّق منها باستخدام إضافة من المكتبة أو تحميل.
3. انتقِل إلى قسم تم رصد وظائف التطبيق في حزمة تطبيقك للتأكّد من إصدار التطبيق المرتبط وعدد الأدوات وعدد لغات بطاقة بيانات المتجر واستهداف البلدان في تطبيق Play، والتأكّد من أنّ عمليات التحقّق الآلية لا تُظهر أيّ مشاكل تؤدي إلى حظر التطبيق.
4. انقر على إرسال التطبيق المرتبط والمتابعة، وأكمِل تفاصيل الإصدار، وأرسِل الإصدار العلني من تطبيقك على Google Play لمراجعته وطرحه.

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

بعد الموافقة على الإصدار العلني لتطبيقك على Google Play وطرحه:

• يصبح تطبيقك المرتبط الذي يستخدم MCP على Android متاحًا في Gemini على Android للمستخدمين في البلدان وباللغات التي يستهدفها تطبيقك على Google Play.
• في صفحة إدارة التطبيق المرتبط (التطبيقات المرتبطة > إدارة)، يتم تعديل بطاقة حالة التطبيق المرتبط إلى تم النشر، ويظهر رمز إصدار حزمة التطبيق المنشور وتاريخ نشره، ويظهر الإصدار ضمن تم النشر في صفحة الإصدارات.
• لإرسال أدوات AppFunctions المحدَّثة لاحقًا، أنشِئ حزمة تطبيق جديدة برمز إصدار أعلى، واختبِرها باستخدام مسار اختبار، ثم انشر إصدارًا جديدًا في قناة الإصدار العلني على Google Play. إذا أردت أيضًا تعديل البيانات الوصفية العلنية لتطبيقك المرتبط (مثل الإمكانات أو نماذج الطلبات)، احفظ هذه التعديلات ضمن التطبيقات المرتبطة > إدارة > تفاصيل التطبيق قبل تحميل حزمة التطبيق الجديدة.

يُرجى تحديث حزمة تطبيقك لتعديل AppFunctions

إذا أردت تكرار AppFunctions أثناء الاختبار الداخلي بدون زيادة رمز إصدار تطبيق Android، يمكنك إزالة وحذف حزمة تطبيق مسودة غير منشورة قبل إعادة تحميلها:

1. يُرجى تعديل تنفيذ AppFunctions في مشروع Android وإنشاء حزمة تطبيق .aab جديدة.
2. أزِل حِزمة التطبيق السابقة من أي إصدار تمهيدي أضفتها إليه:
   1. افتح تطبيقك المرتبط على Google Play في Google Connected Console واختَر الاختبار الداخلي (أو المسار الذي يحتوي على الإصدار التمهيدي) في قائمة التنقّل اليمنى.
   2. في الإصدار التمهيدي، انقر على تعديل الإصدار.
   3. ابحث عن حزمة التطبيق، وانقر على قائمة الخيارات الإضافية (⋮)، ثم انقر على إزالة حزمة التطبيق.
   4. انقر على الحفظ كمسودة.
3. احذف حِزمة التطبيق غير المستخدَمة من مكتبتك:
   1. في قائمة التنقّل اليمنى في تطبيق Play، اختَر أحدث الإصدارات والحِزم (إذا لم تظهر الحزمة في القائمة، اختَر عرض جميع حِزم التطبيقات).
   2. افتح تفاصيل حِزمة التطبيق، وإذا كان زر حذف حِزمة التطبيق متاحًا، انقر عليه. يؤدي ذلك إلى إخلاء رمز الإصدار حتى تتمكّن من تحميل حزمة التطبيق المحدَّثة بدون زيادة رمز الإصدار.
4. إذا لم يكن خيار حذف حزمة التطبيق متاحًا (على سبيل المثال، لأنّ الإصدار قد تم نشره في قناة إصدار)، يمكنك زيادة versionCode في إعدادات تصميم التطبيق، وإنشاء حزمة تطبيق جديدة، وتحميل الإصدار الجديد وإرساله كما هو موضّح في الخطوة 4.

تحديد المشاكل المتعلّقة بـ AppFunctions وحلّها

استخدِم الإرشادات التالية لحلّ أخطاء عمليات التحقّق الآلية ومشاكل الإعداد الشائعة.

حلّ أخطاء عمليات التحقّق الآلية في إصدار معيّن

تظهر أي مشاكل يتم رصدها من خلال عمليات التحقّق الآلية من AppFunctions في صفحة التحضير للإصدار (مثل إنشاء إصدار للاختبار الداخلي) وضمن قسم تعذّر النشر (مع شارة حلّ المشاكل للنشر) في صفحة الإصدارات الخاصة بتطبيقك المرتبط.

إذا أبلغت عمليات الفحص الآلي عن مشاكل في حِزمة تطبيقك، يُرجى اتّباع الخطوات التالية:

1. يُرجى حلّ المشاكل الأساسية في AppFunctions في رمز تطبيق Android وإنشاء حزمة تطبيق محدَّثة.
2. إذا كان الإصدار السابق لا يزال مسودة وتريد إعادة استخدام رمز الإصدار نفسه:
   1. في قائمة التنقّل اليمنى لتطبيقك على Google Play، اختَر الاختبار الداخلي (أو المسار ذي الصلة) ثم اختَر تعديل الإصدار في الإصدار التمهيدي.
   2. انقر على قائمة الخيارات الإضافية (⋮) بجانب حزمة التطبيق واختَر إزالة حزمة التطبيق.
   3. انقر على الحفظ كمسودة.
   4. في قائمة التنقّل اليمنى، اختَر أحدث الإصدارات والحِزم (انقر على عرض جميع حِزم التطبيقات إذا لزم الأمر)، ثم اختَر الحزمة وانقر على حذف حزمة التطبيق.
   5. ارجع إلى الإصدار التمهيدي، وحمِّل حِزمة التطبيق التي تم إصلاحها، ثم انقر على إرسال التطبيق المرتبط والمتابعة.
3. إذا تعذّر حذف الحزمة السابقة، يمكنك زيادة قيمة versionCode في حزمة تطبيقك، وتحميل الحزمة الجديدة إلى إصدارك، ثم النقر على إرسال التطبيق المرتبط والمتابعة.

المشاكل الشائعة في الإعداد والدمج

يوضّح الجدول التالي المشاكل الشائعة التي قد تواجهها أثناء إعداد التطبيق المرتبط أو تحميل الحِزمة أو الاختبار، بالإضافة إلى أسبابها وحلولها:

المشكلة	رسالة من وحدة التحكّم أو العرَض	السبب	درجة الدقة
تم تحميل حِزمة التطبيق قبل إنشاء تطبيق مرتبط أو ربطه	تعرض صفحة الإصدار إنشاء تطبيق مرتبط أو ربطه.	يحتوي ملف .aab الذي تم تحميله على AppFunctions، ولكن تطبيق Google Play غير مرتبط بعد بتطبيق متصل بمنصة MCP على Android.	أكمِل الخطوة 1 إلى الخطوة 3 لإنشاء تطبيق مرتبط، واختَر Android MCP، واربط تطبيقك على Play، واحفظ تفاصيل التطبيق. بعد ذلك، يمكنك حذف حزمة التطبيق وإعادة تحميلها أو تحميل حزمة جديدة باستخدام versionCode متزايد.
تم تحميل حِزمة التطبيق قبل حفظ تفاصيل التطبيق المرتبط	تعرض صفحة الإصدار رسالة تفاصيل التطبيق المرتبط مطلوبة وزر تقديم تفاصيل التطبيق المرتبط.	تطبيق Google Play مرتبط بتطبيق Android متصل ببروتوكول MCP، ولكن لم يتم حفظ الحقول المطلوبة في صفحة تفاصيل التطبيق قبل تحميل الحزمة.	اختَر تقديم تفاصيل التطبيق المرتبط (أو انتقِل إلى التطبيقات المرتبطة > إدارة > إضافة تفاصيل التطبيق)، وأكمِل جميع الحقول المطلوبة واحفظها، ثم احذف الحزمة وأعِد تحميلها أو حمِّل حزمة جديدة باستخدام versionCode متزايد.
يتعذّر اختيار تطبيق Google Play عند الربط	يعرض تطبيق Play المستهدَف شارة مرتبط حاليًا أو لا يظهر في مربّع الحوار اختيار التطبيق.	يمكن ربط كل تطبيق على Google Play بتطبيق واحد فقط متصل بمنصة MCP على Android، أو لم يتم إنشاء تطبيق Google Play في حساب المطوّر هذا بعد.	اطّلِع على الإدخالات الحالية ضمن التطبيقات المرتبطة لمعرفة ما إذا كان هناك تطبيق مرتبط آخر مرتبطًا بتطبيقك على Play، أو أنشئ تطبيق Play في Google Connected Console أولاً قبل الربط.
تعذُّر إنشاء تطبيق مرتبط	لا يتوفّر خيار إنشاء تطبيق مرتبط، أو يؤدي إنشاء تطبيق مرتبط إلى عرض تحذير بشأن الأذونات أو بنود الخدمة.	لا يملك حساب المستخدم الخاص بك أذونات التطبيقات المرتبطة، أو لم يوافق صاحب الحساب أو المشرف بعد على "بنود خدمة التطبيقات المرتبطة".	اطلب من صاحب الحساب أو المشرف الموافقة على "بنود خدمة ربط التطبيقات" ومنح حسابك الإذن عرض التطبيقات المرتبطة أو إنشاء التطبيقات المرتبطة وإدارتها في صفحة المستخدمون والأذونات.
توقُّف إصدار التطبيق المرتبط عند الحالة "في انتظار الإرسال"	في صفحة التطبيقات المرتبطة > إدارة > الإصدارات، يظهر إصدار الحزمة ضمن في انتظار الإرسال بدلاً من متاح للمختبِرين.	رصدت Google Connected Console دوال AppFunctions في الحزمة التي حمّلتها، ولكن لم يتم إرسال إصدار التطبيق المرتبط من صفحة الإصدار.	افتح إصدار تطبيق Play الذي يتضمّن هذه الحزمة، ثم انقر على إرسال التطبيق المرتبط والمتابعة ليتمكّن المختبِرون من معاينته.
مثال على خطأ في التحقّق من الطلبات في صفحة "تفاصيل التطبيق"	لا يمكن حفظ نموذج بطاقة التطبيق المتاحة للجميع ويظهر خطأ ضمن أمثلة على الطلبات.	لا تستوفي الطلبات قواعد التنسيق أو الإشارة، أو تم تعديل اسم التطبيق بعد كتابة الطلبات.	يُرجى تقديم ثلاثة إلى أربعة طلبات في المجموع: ابدأ طلبَين على الأقل بـ "@<YourAppName>"، وأشِر إلى "<YourAppName>" بشكل طبيعي بدون "@" في طلب واحد على الأقل، وأزِل البادئات المرقّمة (1.، 2.) أو علامات الاقتباس المحيطة ("...").
التطبيق المرتبط لا يظهر للمختبِرين في Gemini على Android	لا يمكن للمختبِرين العثور على التطبيق المرتبط ضمن التطبيقات المرتبطة أو باستخدام إشارة @ في تطبيق Gemini على Android.	لا تزال عملية النشر جارية، أو حساب المختبِر غير مؤهَّل، أو إصدار التطبيق المثبَّت غير متطابق.	انتظِر لمدة 20 دقيقة تقريبًا بعد الإرسال (وما يصل إلى 10 دقائق بعد حفظ المختبِرين). تأكَّد من أنّ المختبِر يستخدم حساب @gmail.com شخصيًا في قائمة عناوين البريد الإلكتروني المحفوظة، ويستخدم هاتف Android أو جهاز Android لوحيًا، وقد ثبَّت إصدار الحزمة نفسه الذي تم إرساله.