ایجاد و مدیریت کردن «برنامه‌های متصل‌شده» بااستفاده از AppFunctions و MCP Android در «کنسول متصل Google»

از «کنسول متصل Google» برای ادغام AppFunctions درون‌دستگاهی برنامه Android خود با Gemini در Android استفاده کنید. با ایجاد برنامه متصل‌شده با نوع اتصال MCP Android و پیوند دادن آن به برنامه Play خود، به Gemini در Android امکان می‌دهید کنش‌ها را راه‌اندازی کند و تکالیف را مستقیماً در برنامه شما ازطرف کاربران تکمیل کند.

این راهنما شما را با گردش کار سلف‌سرویس سرتاسری در «کنسول متصل» Google آشنا می‌کند، ازجمله ایجاد برنامه متصل، پیوند دادن برنامه Play، پیکربندی کارت برنامه عمومی، بارگذاری و ارسال بسته برنامه، آزمایش پیش‌نمایش در دستگاه، و انتشار نسخه نهایی.

پیش‌نیازها

قبل‌از شروع، مطمئن شوید موارد زیر را داشته باشید:

• دسترسی به حساب توسعه‌دهنده ثبت‌شده در کنسول متصل‌شده Google:
  • پذیرش «شرایط خدمات»: اولین باری که سازمانتان در «کنسول متصل Google» به «برنامه‌های متصل‌شده» دسترسی پیدا می‌کند، صاحب حساب یا سرپرست باید «شرایط خدمات برنامه‌های متصل‌شده» را مرور و قبول کند تا اعضای تیم بتوانند «برنامه‌های متصل‌شده» ایجاد کنند.
  • اجازه‌های کاربر: اگر به حساب توسعه‌دهنده «کنسول متصل‌شده» موجودی دعوت شده‌اید اما نمی‌توانید «برنامه‌های متصل‌شده» ایجاد کنید، از صاحب حساب یا سرپرست خود بخواهید اجازه مشاهده برنامه‌های متصل‌شده یا ایجاد و مدیریت برنامه‌های متصل‌شده را در صفحه کاربران و اجازه‌ها به شما اعطا کند. همچنین برای بارگذاری بسته‌های برنامه و مدیریت نسخه‌های پخش، به اجازه‌های مدیریت نسخه پخش برای برنامه Play مربوطه نیاز دارید.
• برنامه Play موجود در حساب «کنسول متصل Google» شما:
  • برنامه Play شما باید ازقبل در همان حساب توسعه‌دهنده وجود داشته باشد تا بتوانید آن را به برنامه متصل‌شده‌تان پیوند دهید. هر برنامه Play را فقط می‌توان به یک برنامه متصل‌شده MCP Android پیوند داد.
  • مطمئن شوید برنامه Play شما فهرستگان فروشگاه پیش‌فرضی دارد که با نماد برنامه و زبان‌های پشتیبانی‌شده پیکربندی شده است. زبان‌های فهرستگان مکان برنامه Play و هدف‌یابی کشور تعیین می‌کنند که برنامه متصل‌شده MCP Android شما در کجا دردسترس باشد.
• «بسته ترکیبی برنامه Android»‏ (.aab) با AppFunctions پیاده‌سازی‌شده:
  • دسته برنامه‌تان را برای هدف‌یابی دستگاه‌های همراه Android پیکربندی کنید، که پلاتفرم پشتیبانی‌شده برای ادغام برنامه Gemini در دستگاه است.
• دسته برنامه متصل‌شده و فراداده عمومی: دارایی‌ها و جزئیاتی را که نمای عمومی برنامه متصل‌شده‌تان را شکل می‌دهند آماده کنید:
  • دسته برنامه متصل‌شده: دسته دامنه یا صنعت برای برنامه متصل‌شده شما. هر دسته الزامات ظرفیت پایه را تعریف می‌کند و پس‌از ایجاد قابل‌تغییر نیست.
  • نام برنامه: نام نمایشی برنامه متصل‌شده شما که به کاربران در سراسر محصولات Google نشان داده می‌شود و زمانی استفاده می‌شود که کاربران با @ در Gemini از برنامه شما نام می‌برند.
  • نماد برنامه متصل: نماد برنامه ۵۱۲ پیکسل در ۵۱۲ پیکسل در قالب JPEG یا PNG، با حداکثر اندازه فایل ۱ مگابایت (۱۰۲۴ کیلوبایت).
  • شرح برنامه: خلاصه‌ای مختصر که توضیح می‌دهد برنامه متصل‌شده شما چه کارهایی می‌تواند برای کاربران انجام دهد.
  • قابلیت‌های برنامه: حداقل سه قابلیت سفارشی که به کاربران نشان می‌دهد برنامه شما هنگام تصمیم‌گیری برای متصل شدن چه کارهایی می‌تواند انجام دهد، علاوه‌بر هرگونه قابلیت پیش‌فرضی که براساس دسته برنامه‌تان تعریف شده است.
  • نمونه پیام‌واره‌ها: حداقل سه نمونه پیام‌واره که به کاربران آموزش می‌دهد چگونه برنامه شما را در Gemini فراخوانی کنند و به آن‌ها کمک می‌کند بفهمند چه چیزهایی می‌توانند بپرسند.
  • نشانی وب خط‌مشی: نشانی وب «خط‌مشی رازداری» شما که به‌طور عمومی دردسترس باشد.
  • نشانی وب شرایط خدمات: نشانی وب قابل‌دسترس عمومی برای شرایط خدمات شما.
  • نشانی وب‌سایت (اختیاری): نشانی وب با دسترسی عمومی که برای ارجاع به وب‌سایت شما اشاره می‌کند.

ثبت، آزمایش، و انتشار AppFunctions با Gemini

پس‌از برآورده کردن پیش‌نیازها، مراحل زیر را برای ثبت کردن برنامه متصل‌شده MCP Android خود، پیوند دادن برنامه Play، پر کردن جزئیات برنامه، بارگذاری و ارسال AppFunctions، آزمایش کردن در دستگاه، و انتشار در محیط تولید تکمیل کنید.

مرحله ۱: برنامه متصل‌شده MCP Android ایجاد کنید و آن را به برنامه Play خود پیوند دهید

برای ایجاد برنامه متصل‌شده و پیوند دادن آن به برنامه Play، این مراحل را دنبال کنید:

1. به سیستم Google Connected Console وارد شوید.
2. در صفحه صفحه اصلی، ایجاد برنامه را انتخاب کنید.
3. در کادر گفتگوی انتخاب آنچه می‌خواهید ایجاد کنید:
   • اگر از شما خواسته شد «شرایط خدمات برنامه‌های متصل‌شده» را بپذیرید، مشاهده شرایط را انتخاب کنید، قرارداد را مرور و قبول کنید، و سپس ایجاد را انتخاب کنید. فقط سرپرست حساب می‌تواند قرارداد را بپذیرد.
   • درغیراین‌صورت، ایجاد را در کارت برنامه متصل‌شده انتخاب کنید.
4. در کادر گفتگوی نامی برای برنامه متصل‌شده خود انتخاب کنید، نامی برای برنامه متصل‌شده خود تایپ کنید. این نامی است که برنامه متصل‌شده شما را در سراسر محصولات Google نمایش می‌دهد و کاربران بااستفاده از @ از برنامه متصل‌شده شما نام می‌برند. بعدی را انتخاب کنید.

5. در کادر گفتگوی انتخاب دسته برنامه متصل‌شده، دامنه، دسته، یا صنعت برنامه‌تان را از منو انتخاب دسته انتخاب کنید.

6. در کادر گفتگوی انتخاب نوع اتصال، Android MCP را انتخاب کنید.

   برای راهنمای گام‌به‌گام دقیق درباره راه‌اندازی برنامه متصل‌شده سرور MCP، راهنمای ادغام «کنسول Google Play» را ببینید. درحال‌حاضر، فقط می‌توانید یک نوع اتصال برای هر برنامه متصل‌شده انتخاب کنید و نمی‌توانید بعداً آن را تغییر دهید.

7. ایجاد برنامه متصل‌شده را انتخاب کنید.

8. در کادر گفتگوی انتخاب برنامه، برنامه Play را که حاوی (یا دربردارنده) AppFunctions شما است پیدا و انتخاب کنید. می‌توانید فهرست را بااستفاده از جستجو فیلتر کنید.

   • برنامه‌های Play که قبلاً به برنامه متصل‌شده دیگری پیوند شده‌اند قابل انتخاب نیستند.
   • حتماً برنامه Play صحیح را که می‌خواهید پیوند کنید انتخاب کنید. وقتی برنامه Play را انتخاب کردید، دیگر نمی‌توانید آن را تغییر دهید.

با این کار، صفحه نمای کلی مدیریت برای برنامه متصل‌شده شما باز می‌شود که در آنجا می‌توانید به پیکربندی جزئیات برنامه متصل‌شده خود ادامه دهید، نسخه‌های برنامه متصل‌شده خود را ردیابی کنید، و آزمایش‌گران را مدیریت کنید.

مرحله ۲: جزئیات برنامه متصل‌شده را ارائه دهید

قبل‌از بارگذاری هر دسته برنامه حاوی AppFunctions، نحوه نمایش برنامه متصل‌شده خود را برای کاربران در Gemini پیکربندی کنید.

برای ارائه جزئیات برنامه متصل‌شده، این مراحل را دنبال کنید:

1. در صفحه مدیریت برنامه متصل‌شده، در کارت MCP Android در بخش افزودن جزئیات برنامه متصل‌شده، افزودن جزئیات برنامه (یا مدیریت درصورت به‌روزرسانی جزئیات موجود) را انتخاب کنید.
2. در بالای صفحه جزئیات برنامه، فیلد نام برنامه متصل‌شده را درستی‌سنجی کنید. درصورت لزوم می‌توانید نام را به‌روز کنید. این نام به کاربران در سراسر محصولات Google نمایش داده می‌شود و زمانی استفاده می‌شود که کاربران با @ از برنامه شما نام می‌برند.
3. در بخش جزئیات عمومی، در قسمت نماد، نماد برنامه‌تان را بارگذاری کنید (JPG یا PNG، حداکثر ۱ مگابایت، و ۵۱۲ پیکسل در ۵۱۲ پیکسل).

4. فیلدهای زیر را تکمیل کنید:

   • شرح: خلاصه مختصر و تک‌جمله‌ای (کمتر از ۳۰ کلمه) وارد کنید که ویژگی‌های اصلی برنامه متصل‌شده شما و کارهایی را که می‌تواند انجام دهد شرح دهد. این نوشتار به کاربران نشان داده می‌شود و به‌عنوان دستورالعمل‌های مدل استفاده نمی‌شود.
   • قابلیت‌ها: حداقل سه تکلیف باارزش را که برنامه متصل‌شده شما می‌تواند اجرا کند وارد کنید. برای افزودن ورودی‌های بیشتر، افزودن قابلیت را انتخاب کنید. در ابتدای توانمندی‌هایتان عدد قرار ندهید. در هر ورودی فقط یک قابلیت را اضافه کنید. اگر دسته برنامه متصل‌شده شما شامل قابلیت‌های ازپیش تعریف‌شده باشد، این قابلیت‌ها در بالای فهرست نشان داده می‌شوند و قابل‌تغییر نیستند.
   • پیام‌واره‌های نمونه: حداقل سه پیام‌واره نمونه وارد کنید که به کاربران کمک کند متوجه شوند چه سؤالاتی می‌توانند بپرسند. برای افزودن ورودی، افزودن پیام‌واره نمونه را انتخاب کنید.
     • حداقل دو پیام‌واره را با @<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>
     

     «کنسول متصل‌شده» به‌طور خودکار برچسب‌هایتان را اعتبارسنجی می‌کند و مکان‌های شناسایی‌شده را زیر هر فیلد نمایش می‌دهد (برای مثال، Found translations for 2 languages: en-US, es-ES).

   • نشانی وب شرایط خدمات: پیوند https:// یا http:// معتبری به «شرایط خدمات» خود وارد کنید.

   • نشانی وب خط‌مشی: پیوند https:// یا http:// معتبری به «خط‌مشی رازداری» خود وارد کنید.

   • نشانی وب‌سایت (اختیاری): پیوندی به وب‌سایتتان برای اهداف ارجاع وارد کنید.

مرحله ۳: دسته برنامه‌ای حاوی AppFunctions بارگذاری کنید و برنامه متصل‌شده‌تان را ارسال کنید

پس‌از ذخیره کردن جزئیات برنامه متصل‌شده، یک «بسته ترکیبی برنامه Android» حاوی AppFunctions خود را در برنامه Play پیوندشده‌تان بارگذاری کنید و نسخه برنامه متصل‌شده را برای آزمایش ارسال کنید.

برای بارگذاری دسته برنامه‌ای که حاوی AppFunctions شما است، این مراحل را دنبال کنید:

1. در صفحه مدیریت برنامه متصل‌شده، در کارت Android MCP در بخش بارگذاری دسته برنامه‌ای که حاوی AppFunctions شما است، بارگذاری دسته برنامه را انتخاب کنید تا به نمای کلی آزمایش و انتشار برنامه Play پیوندشده بروید.
2. یا برنامه Play پیوندشده‌تان را مستقیماً در «کنسول متصل Google» باز کنید. در منو پیمایش سمت راست برنامه Play، به آزمایش > آزمایش داخلی (یا دسته هدف آزمایشی دیگر) بروید و ایجاد نسخه پخش جدید (یا ویرایش نسخه پخش اگر ازقبل نسخه پخش پیش‌نویس دارید) را انتخاب کنید.
3. در بخش دسته‌های برنامه، گزینه بارگذاری را انتخاب کنید تا دسته .aab خود را با AppFunctions بارگذاری کنید، یا اگر دسته را پس‌از تکمیل مرحله ۲ بارگذاری کرده‌اید، گزینه افزودن از کتابخانه را انتخاب کنید.
4. پس‌از تکمیل بارگذاری، به بخش توابع برنامه در دسته برنامه شما شناسایی شد در صفحه انتشار بروید. تأیید کنید که نام برنامه متصل‌شده، کد نسخه بسته، تعداد ابزارهای شناسایی‌شده، تعداد زبان‌ها، و هدف‌یابی کشور برنامه Play همان‌طور که انتظار می‌رود نشان داده می‌شود و درستی‌سنجی کنید که بررسی‌های خودکار هیچ مشکلی را گزارش نمی‌کنند. (اگر خطای اعتبارسنجی‌ای ظاهر شد، قبل‌از ادامه دادن، دستورالعمل‌های عیب‌یابی مشکلات مربوط به AppFunctions را دنبال کنید.)
5. در پایین صفحه انتشار، ارسال برنامه متصل‌شده و ادامه را انتخاب کنید.

با انتخاب ارسال برنامه متصل‌شده و ادامه، نسخه AppFunctions شما برای آزمایش پیش‌دید به Gemini ارسال می‌شود و انتشار Play شما به صفحه پیش‌دید انتشار منتقل می‌شود. اگر می‌خواهید AppFunctions را بااستفاده از نسخه‌های محلی تکرار کنید بدون اینکه کد نسخه دسته برنامه‌تان را افزایش دهید، نسخه پخش Play را در حالت «پیش‌نویس» رها کنید و ذخیره و انتشار را انتخاب نکنید. انتشار نسخه پخش Play کد نسخه آن دسته را قفل می‌کند تا دیگر نتوان آن را حذف و دوباره بارگذاری کرد. هرگونه تغییر بعدی مستلزم کد نسخه بسته برنامه افزایش‌یافته است. (اگر آزمایش‌کنندگان شما برنامه را مستقیماً از دسته هدف آزمایشی داخلی Google Play نصب می‌کنند و نه ازطریق بارگذاری جانبی، عرضه آزمایشی داخلی را تکمیل کنید و کد نسخه را در بارگذاری‌های آتی افزایش دهید.)

مرحله ۴: درستی‌سنجی نسخه برنامه متصل‌شده

پس‌از ارسال برنامه متصل‌شده از صفحه انتشار Play، درستی‌سنجی کنید که نسخه برنامه متصل‌شده برای پیش‌دید آماده باشد:

1. در صفحه مدیریت برنامه متصل‌شده، در کارت Android MCP، در کنار نسخه‌ها، مشاهده را انتخاب کنید.
2. در صفحه نسخه‌ها، مطمئن شوید نسخه ارسالی‌تان در بخش دردسترس برای آزمایش‌کنندگان (نمایش Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>) نشان داده می‌شود.
   • مشاهده را در هر ردیف نسخه انتخاب کنید تا AppFunctions شناسایی‌شده و عکس آنی فقط خواندنی جزئیات برنامه را که برای آن نسخه گرفته شده است بررسی کنید.
   • نسخه‌های ایجادشده از دسته برنامه بارگذاری‌شده که هنوز برای آن‌ها ارسال برنامه متصل‌شده و ادامه را انتخاب نکرده‌اید در بخش درانتظار ارسال نشان داده می‌شوند.

مرحله ۵: آزمایش کردن برنامه متصل‌شده

برای اینکه برنامه متصل‌شده‌تان را برای آزمایش‌گران دردسترس کنید، باید آن‌ها را در صفحه مدیریت آزمایش‌گران اضافه کنید. فقط کاربرانی که به فهرست آزمایش‌گران خود اضافه می‌کنید می‌توانند برنامه متصل‌شده منتشرنشده شما را ببینند و با آن تعامل داشته باشند. فقط می‌توانید آزمایش‌گرانی را اضافه کنید که حساب @gmail.com دارند.

1. در صفحه نمای کلی برنامه متصل‌شده، در کارت آزمایش کردن برنامه، افزودن آزمایشگر (یا مدیریت آزمایشگران اگر قبلاً آزمایشگر اضافه کرده‌اید) را انتخاب کنید.
2. در صفحه مدیریت آزمایش‌کنندگان، فهرست‌های ایمیل موجود را انتخاب کنید یا ایجاد فهرست ایمیل را انتخاب کنید تا «حساب‌های Google» مجاز برای آزمایش ادغام را اضافه کنید. اگر می‌خواهید خودتان برنامه را آزمایش کنید، حتماً نشانی ایمیل خودتان را اضافه کنید.

3. ذخیره را انتخاب کنید.

4. آزمایش‌گران در برنامه Gemini می‌توانند با تایپ کردن @ و سپس نام برنامه متصل‌شده شما و انتخاب آن از منو، برنامه متصل‌شده شما را فراخوانی کنند. همچنین می‌توانید با رفتن به تنظیمات و راهنمایی > برنامه‌های متصل‌شده در نوار پیمایش سمت راست، برنامه خود را در Gemini مشاهده و متصل کنید.

قبل‌از آزمایش در دستگاه، مطمئن شوید که هر آزمایش‌کننده شرایط زیر را دارد:

• بااستفاده از «حساب Google» موجود در فهرست ایمیل پیکربندی‌شده در مرحله ۵، به سیستم تلفن همراه یا رایانه لوحی Android وارد شده باشید.
• اجرای دقیق ساخت برنامه Android که کد نسخه دسته آن با نسخه ارسال‌شده در مرحله ۴ مطابقت دارد.

توصیه می‌کنیم ادغام را به‌طور کامل آزمایش کنید:

• همه پیام‌واره‌های نمونه خود را امتحان کنید.
• هم فراخوانی‌های صریح @<AppName> و هم پُرسمان‌های زبان طبیعی را آزمایش کنید.
• مدیریت پارامتر ابزار، پیام‌واره‌های تأیید، و اجرای سرتاسر را در AppFunctions خود درستی‌سنجی کنید.

وقتی از آزمایش خود راضی بودید، آماده‌اید تا برنامه متصل‌شده خود را برای بازبینی به Google ارسال کنید.

مرحله ۶: «برنامه متصل‌شده» خود را برای کاربران منتشر کنید

برخلاف ادغام‌های MCP با میزبانی سرور، برنامه متصل‌شده Android MCP به بازبینی یا کنش انتشار جداگانه در صفحه مدیریت «برنامه متصل‌شده» نیاز ندارد. درعوض، نسخه برنامه متصل‌شده شما توسط Google بازبینی می‌شود و وقتی نسخه برنامه Play حاوی دسته برنامه AppFunctions را در تولید منتشر می‌کنید، به‌طور خودکار منتشر می‌شود.

وقتی آزمایش را تکمیل کردید و آماده راه‌اندازی برای کاربران بودید:

1. در «کنسول Google Connected»، برنامه Play پیوندشده‌تان را باز کنید و در منو پیمایش سمت راست به انتشار > تولید بروید (یا نسخه پخش آزمایش‌شده‌تان را از دسته هدف آزمایشی به تولید ارتقا دهید).
2. ایجاد نسخه پخش جدید را انتخاب کنید (یا نسخه پخش تولید پیش‌نویس موجود را ویرایش کنید) و دسته برنامه حاوی AppFunctions تأییدشده‌تان را بااستفاده از افزودن از کتابخانه یا بارگذاری اضافه کنید.
3. به بخش AppFunctions were detected in your app bundle بروید تا نسخه برنامه متصل‌شده، تعداد ابزارها، تعداد زبان‌های فهرستگان مکان، و هدف‌یابی کشور برنامه Play را تأیید کنید و مطمئن شوید بررسی‌های خودکارشده هیچ مشکل مسدودکننده‌ای را نشان نمی‌دهد.
4. ارسال برنامه متصل‌شده و ادامه را انتخاب کنید، جزئیات نسخه پخش را تکمیل کنید، و نسخه پخش تولید برنامه Play را برای بازبینی و عرضه ارسال کنید.

پس‌از تأیید و عرضه نسخه تولید برنامه Play:

• برنامه متصل‌شده MCP Android شما در Gemini در Android برای کاربران در کشورها و زبان‌های هدف برنامه Play شما دردسترس قرار می‌گیرد.
• در صفحه مدیریت برنامه متصل‌شده (برنامه‌های متصل‌شده > مدیریت)، کارت وضعیت برنامه متصل‌شده به منتشرشده به‌روز می‌شود و کد نسخه دسته برنامه فعال و تاریخ انتشار را نمایش می‌دهد و نسخه در زیر منتشرشده در صفحه نسخه‌ها ظاهر می‌شود.
• برای ارسال ابزارهای AppFunctions به‌روزشده در آینده، بسته برنامه جدیدی با کد نسخه افزایش‌یافته بسازید، آن را بااستفاده از دسته هدف آزمایشی آزمایش کنید، و نسخه پخش جدیدی در تولید Play منتشر کنید. اگر می‌خواهید فراداده عمومی برنامه متصل‌شده‌تان (مثل قابلیت‌ها یا پیام‌واره‌های نمونه) را نیز به‌روز کنید، قبل‌از بارگذاری کردن دسته برنامه جدیدتان، آن ویرایش‌ها را در برنامه‌های متصل‌شده > مدیریت > جزئیات برنامه ذخیره کنید.

برای اصلاح AppFunctions، دسته برنامه‌تان را به‌روز کنید

اگر می‌خواهید درطول آزمایش داخلی بدون افزایش کد نسخه برنامه Android خود، AppFunctions را تکرار کنید، می‌توانید قبل‌از بارگذاری مجدد، یک دسته برنامه پیش‌نویس منتشرنشده را بردارید و حذف کنید:

1. پیاده‌سازی AppFunctions را در پروژه Android خود به‌روز کنید و دسته برنامه .aab جدیدی تولید کنید.
2. دسته برنامه قبلی را از هر نسخه پیش‌نویسی که آن را اضافه کرده‌اید بردارید:
   1. برنامه Play پیوندشده‌تان را در «کنسول متصل‌شده Google» باز کنید و آزمایش داخلی (یا دسته‌ای که حاوی نسخه پیش‌نویس شما است) را در منو پیمایش سمت راست انتخاب کنید.
   2. در نسخه پیش‌نویس، ویرایش نسخه را انتخاب کنید.
   3. دسته برنامه را پیدا کنید، منوِ سه‌نقطه‌ای (⋮) را انتخاب کنید، و برداشتن دسته برنامه را انتخاب کنید.
   4. ذخیره به‌عنوان پیش‌نویس را انتخاب کنید.
3. دسته برنامه استفاده‌نشده را از کتابخانه‌تان حذف کنید:
   1. در منو پیمایش سمت راست برنامه Play، جدیدترین نسخه‌های پخش و دسته‌ها را انتخاب کنید (اگر دسته موردنظر را در فهرست نمی‌بینید، مشاهده همه دسته‌های برنامه را انتخاب کنید).
   2. جزئیات دسته برنامه‌تان را باز کنید و اگر دکمه حذف دسته برنامه دردسترس است، حذف دسته برنامه را انتخاب کنید. این کار کد نسخه را آزاد می‌کند تا بتوانید دسته برنامه به‌روزشده را بدون افزایش کد نسخه بارگذاری کنید.
4. اگر حذف دسته برنامه دردسترس نیست (برای مثال، چون نسخه پخش قبلاً در دسته هدف منتشر شده است)، versionCode را در پیکربندی ساخت برنامه افزایش دهید، دسته برنامه جدیدی تولید کنید، و نسخه جدید را همان‌طور که در مرحله ۴ شرح داده شده است بارگذاری و ارسال کنید.

عیب‌یابی مشکلات مربوط به AppFunctions

برای حل کردن خطاهای بررسی خودکار و مشکلات رایج راه‌اندازی، از راهنمایی‌های زیر استفاده کنید.

برطرف کردن خطاهای بررسی خودکار در نسخه پخش

هرگونه مشکلی که توسط بررسی‌های خودکار AppFunctions شناسایی شود در صفحه آماده‌سازی نسخه پخش (مانند ایجاد نسخه پخش آزمایشی داخلی) و در بخش ناموفق (با نشان رفع مشکلات برای انتشار) در صفحه نسخه‌ها برنامه متصل‌شده شما ظاهر می‌شود.

اگر بررسی‌های خودکار مشکلاتی را در دسته برنامه‌تان گزارش کرد، مراحل زیر را انجام دهید:

1. مشکلات AppFunctions زمینه‌ای را در کد برنامه Android خود برطرف کنید و دسته برنامه به‌روزشده‌ای بسازید.
2. اگر نسخه پخش قبلی‌تان هنوز پیش‌نویس است و می‌خواهید از همان کد نسخه دوباره استفاده کنید:
   1. در منو پیمایش سمت راست برنامه Play، آزمایش داخلی (یا دسته مربوطه) را انتخاب کنید و در نسخه پیش‌نویس، ویرایش نسخه را انتخاب کنید.
   2. منوِ سه‌نقطه‌ای (⋮) کنار دسته برنامه را انتخاب کنید و برداشتن دسته برنامه را انتخاب کنید.
   3. ذخیره به‌عنوان پیش‌نویس را انتخاب کنید.
   4. در منو پیمایش سمت راست، جدیدترین دسته‌ها و نسخه‌های پخش را انتخاب کنید (درصورت نیاز، مشاهده همه دسته‌های برنامه را انتخاب کنید)، دسته را انتخاب کنید، و حذف دسته برنامه را انتخاب کنید.
   5. به نسخه پیش‌نویس برگردید، دسته برنامه اصلاح‌شده را بارگذاری کنید، و ارسال برنامه متصل‌شده و ادامه را انتخاب کنید.
3. اگر بسته قبلی حذف نمی‌شود، versionCode بسته برنامه‌تان را افزایش دهید، بسته جدید را در نسخه پخش خود بارگذاری کنید، و ارسال برنامه متصل‌شده و ادامه دادن را انتخاب کنید.

مشکلات رایج راه‌اندازی و ادغام

جدول زیر مشکلات رایجی را که ممکن است درطول راه‌اندازی برنامه متصل‌شده، بارگذاری دسته، یا آزمایش با آن‌ها مواجه شوید، به‌همراه دلایل و راه‌حل‌های آن‌ها شرح می‌دهد:

مشکل	پیام یا نشانه کنسول	علت	برطرف کردن مشکل
دسته برنامه قبل‌از ایجاد یا پیوند دادن برنامه متصل‌شده بارگذاری شده است	صفحه «انتشار» ایجاد یا پیوند دادن برنامه متصل‌شده را نشان می‌دهد.	.aab بارگذاری‌شده حاوی AppFunctions است، اما برنامه Play هنوز به برنامه متصل‌شده MCP Android پیوند داده نشده است.	مرحله ۱ تا مرحله ۳ را برای ایجاد برنامه متصل‌شده تکمیل کنید، Android MCP را انتخاب کنید، برنامه Play خود را پیوند دهید، و جزئیات برنامه را ذخیره کنید. سپس دسته برنامه را حذف و دوباره بارگذاری کنید یا دسته جدیدی با versionCode افزوده بارگذاری کنید.
دسته برنامه قبل‌از ذخیره کردن جزئیات برنامه متصل‌شده بارگذاری شد	صفحه «نسخه پخش» جزئیات برنامه متصل‌شده لازم است و دکمه ارائه جزئیات برنامه متصل‌شده را نشان می‌دهد.	برنامه Play به برنامه متصل‌شده MCP Android پیوند داده شده است، اما فیلدهای الزامی در صفحه جزئیات برنامه قبل‌از بارگذاری دسته ذخیره نشده است.	ارائه جزئیات برنامه متصل را انتخاب کنید (یا به برنامه‌های متصل > مدیریت > افزودن جزئیات برنامه بروید)، همه فیلدهای الزامی را تکمیل و ذخیره کنید، سپس دسته را حذف و دوباره بارگذاری کنید یا دسته جدیدی با versionCode افزایش‌یافته بارگذاری کنید.
برنامه Play را نمی‌توان هنگام پیوند دادن انتخاب کرد	برنامه Play هدف نشان قبلاً پیوندشده را نشان می‌دهد یا در کادر گفتگوی انتخاب برنامه نشان داده نمی‌شود.	هر برنامه Play فقط می‌تواند به یک برنامه متصل MCP Android پیوند داده شود، یا برنامه Play هنوز در این حساب توسعه‌دهنده ایجاد نشده است.	ورودی‌های موجود را در بخش برنامه‌های متصل بررسی کنید تا ببینید آیا برنامه متصل دیگری قبلاً به برنامه Play شما پیوند داده شده است یا نه، یا ابتدا برنامه Play را در «کنسول متصل‌شده Google» ایجاد کنید و سپس پیوند دهید.
نمی‌توان برنامه متصل‌شده ایجاد کرد	گزینه ایجاد برنامه متصل‌شده وجود ندارد، یا ایجاد برنامه متصل‌شده هشدار اجازه‌ها یا «شرایط خدمات» را نمایش می‌دهد.	حساب کاربری شما اجازه‌های برنامه‌های متصل‌شده را ندارد یا صاحب حساب یا سرپرست هنوز «شروط خدمات برنامه‌های متصل‌شده» را نپذیرفته است.	از سرپرست یا صاحب حساب بخواهید «شرایط خدمات برنامه‌های متصل‌شده» را بپذیرد و در صفحه کاربران و اجازه‌ها، به حساب شما اجازه مشاهده برنامه‌های متصل‌شده یا ایجاد و مدیریت برنامه‌های متصل‌شده را اعطا کند.
نسخه برنامه متصل در وضعیت «درحال انتظار برای ارسال» گیر کرده است	در برنامه‌های متصل‌شده > مدیریت > نسخه‌ها، نسخه دسته شما به‌جای دردسترس برای آزمایش‌گران در زیر درحال انتظار برای ارسال نشان داده می‌شود.	«کنسول متصل Google»‏ AppFunctions را در دسته بارگذاری‌شده شما شناسایی کرد، اما نسخه برنامه متصل‌شده از صفحه انتشار ارسال نشده است.	نسخه پخش برنامه Play حاوی آن دسته را باز کنید و ارسال برنامه متصل‌شده و ادامه را انتخاب کنید تا آزمایشگران بتوانند آن را پیش‌دید کنند.
خطای اعتبارسنجی پیام‌واره‌های نمونه در صفحه «جزئیات برنامه»	فرم کارت برنامه عمومی ذخیره نمی‌شود و خطایی در بخش نمونه پیام‌واره‌ها نمایش داده می‌شود.	پیام‌واره‌ها با قوانین قالب‌بندی یا نام‌بری مطابقت ندارند، یا نام برنامه پس‌از نوشتن پیام‌واره‌ها ویرایش شده است.	درمجموع سه تا چهار پیام‌واره ارائه دهید: حداقل دو پیام‌واره را با @<YourAppName> شروع کنید، در حداقل یک پیام‌واره به‌طور طبیعی و بدون @ از <YourAppName> نام ببرید، و پیشوندهای شماره‌دار (1.، 2.) یا نقل‌قول‌های اطراف ("...") را بردارید.
«برنامه متصل‌شده» برای آزمایش‌گران در Gemini در Android قابل‌مشاهده نیست	آزمایشگران نمی‌توانند برنامه متصل‌شده را در بخش برنامه‌های متصل‌شده یا بااستفاده از نام‌بردن @ در برنامه Gemini ویژه Android پیدا کنند.	انتشار هنوز درحال انجام است، حساب آزمایش‌کننده واجدشرایط نیست، یا نسخه برنامه نصب‌شده مطابقت ندارد.	حدود ۲۰ دقیقه پس‌از ارسال (و حداکثر ۱۰ دقیقه پس‌از ذخیره کردن آزمایش‌کنندگان) صبر کنید. مطمئن شوید آزمایش‌کننده از حساب @gmail.com شخصی در فهرست ایمیل‌های ذخیره‌شده استفاده می‌کند، از تلفن یا رایانه لوحی Android استفاده می‌کند، و دقیقاً همان نسخه دسته ارسال‌شده را نصب کرده است.