ثبت، آزمایش، و منتشر کردن برنامه متصل‌شده

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

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

برای ایجاد برنامه متصل‌شده:

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

4. در کادر گفتگوی نامی برای برنامه متصل‌شده خود انتخاب کنید، نامی برای برنامه متصل‌شده خود تایپ کنید. این نامی است که برای نمایش برنامه متصل‌شده شما در سراسر محصولات Google استفاده خواهد شد و کاربران بااستفاده از @ از برنامه متصل‌شده شما نام خواهند برد. بعدی را انتخاب کنید.

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

   توجه: دسته برنامه متصل‌شده شما الزامات قابلیت پایه را تعریف می‌کند و بعداً قابل‌تغییر نیست. برای استفاده از دسته‌ای دیگر در آینده، باید برنامه متصل‌شده جدیدی ایجاد کنید.

6. در کادر گفتگوی انتخاب نوع اتصال، یکی از گزینه‌های زیر را انتخاب کنید:

   • سرور MCP: سرور MCP را متصل کنید تا سرویس‌هایتان را به کاربران Gemini و «جستجو» در سراسر وب، Android، و iOS ارائه دهید.
   • Android MCP: قابلیت‌های درون‌دستگاهی‌تان را دراختیار Gemini در Android قرار دهید تا بتواند کنش‌ها را راه‌اندازی کند و تکالیف را برای کاربران در برنامه‌تان تکمیل کند.

   درباره نحوه راه‌اندازی برنامه متصل‌شده MCP Android بیشتر بدانید. برای هر برنامه متصل‌شده فقط می‌توانید یک نوع اتصال انتخاب کنید و این انتخاب بعداً قابل‌تغییر نیست.

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

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

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

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

1. در صفحه نمای کلی برنامه متصل‌شده، در ردیف جزئیات برنامه، شروع به کار (یا مدیریت اگر درحال به‌روزرسانی جزئیات موجود هستید) را انتخاب کنید.
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:// معتبری به «خط‌مشی رازداری» خود وارد کنید.

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

5. ذخیره را در پایین صفحه انتخاب کنید تا به صفحه نمای کلی برگردید.

مرحله ۳: نقطه پایان MCP خود را وارد کنید و مالکیت دامنه را به‌تأیید برسانید

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

برای وارد کردن نقطه پایان MCP و درستی‌سنجی کردن مالکیت دامنه:

1. در صفحه نمای کلی برنامه متصل‌شده، در کارت راه‌اندازی MCP و ابزارها، شروع به کار (یا مدیریت، اگر جزئیات موجود را به‌روز می‌کنید) را انتخاب کنید. با این کار، مرحله ۱ (نقطه‌های پایانی سرور MCP) از جریان راه‌اندازی MCP باز می‌شود.
2. در بخش نقطه پایان سرور MCP متصل‌شده، نشانی وب HTTPS کامل نقطه پایان سرور MCP خود را وارد کنید (برای مثال، https://api.yourdomain.com/v1/mcp).

3. در بخش درستی‌سنجی دامنه، درستی‌سنجی کد امنیتی چالش را برای دامنه‌تان تکمیل کنید (اگر قبلاً دامنه یا دامنه ولی آن را در حساب توسعه‌دهنده‌تان درستی‌سنجی کرده باشید، به‌طور خودکار به‌عنوان درستی‌سنجی‌شده نشان داده می‌شود):

   1. در کارت درستی‌سنجی مالکیت دامنه، بارگیری کردن کد را انتخاب کنید. مرورگرتان فایلی به‌نام google-connected-apps.json با ساختار زیر بارگیری می‌کند:

      {
        "verification_tokens": [
          "YOUR_VERIFICATION_TOKEN"
        ]
      }
      

   2. این محتوای JSON را در سرورتان در https://<your-domain>/.well-known/google-connected-apps بارگذاری و میزبانی کنید.

      • مطمئن شوید که نقطه پایانی ازطریق HTTPS به‌طور عمومی دردسترس باشد، HTTP 200 OK را مستقیماً بدون تغییر مسیرهای HTTP برگرداند، و شامل ژتون شما در آرایه verification_tokens باشد.

   3. به «کنسول یکپارچه Google» برگردید و به‌تأیید رساندن دامنه را انتخاب کنید.

   4. پس‌از موفقیت‌آمیز بودن درستی‌سنجی، ردیف دامنه با کد چالش درستی‌سنجی شد علامت تیک سبز نشان می‌دهد و قفل بخش اعتبارنامه دسترسی در زیر آن باز می‌شود.

مرحله ۴: پیکربندی اعتبارنامه‌های دسترسی

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

برای پیکربندی اعتبارنامه‌های دسترسی:

1. در بخش ارائه اطلاعات کاربری دسترسی (در مرحله ۱ صفحه راه‌اندازی MCP و ابزارها)، شروع به کار (یا به‌روزرسانی اطلاعات کاربری برای اصلاح پیکربندی موجود) را انتخاب کنید.

2. در بخش آیا سرورتان به مجوز نیاز دارد؟، یکی از گزینه‌های زیر را انتخاب کنید:

   • نه: اگر سرور MCP شما بدون اصالت‌سنجی به‌طور عمومی قابل‌دسترسی است، این گزینه را انتخاب کنید، سپس تأیید را انتخاب کنید.

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

     • ماشین‌به‌ماشین (اعتبارنامه‌های کارخواه OAuth): این گزینه را برای اصالت‌سنجی سرویس‌به‌سرویس (RFC 6749) انتخاب کنید که در آن Google بااستفاده از «رمز» و «شناسه کارخواه» هم‌رسانی‌شده مستقیماً با سرور MCP شما ارتباط برقرار می‌کند، بدون اینکه به هدایت ورود به سیستم کاربر نهایی نیاز داشته باشد:
       1. شناسه کارخواه (الزامی) و رمز کارخواه (اختیاری) را وارد کنید.
       2. درصورت تمایل، نقطه پایانی مجوز (اختیاری) و نقطه پایانی کد (اختیاری) را وارد کنید، اگر سرورتان آن‌ها را بااستفاده از /.well-known/oauth-authorization-server تبلیغ نمی‌کند.
       3. ثبت کارخواه (یا به‌روزرسانی کارخواه) را انتخاب کنید.

     • واگذارشده به کاربر (کد مجوز): اگر سرور MCP شما از کاربران می‌خواهد بااستفاده از «پیونددهی حساب Google» با حساب‌های خودشان به سیستم وارد شوند و کنش‌ها را مجاز کنند، این گزینه را انتخاب کنید:

       1. شناسه‌های URI هدایت OAuth مربوط به Google را در فهرست مجاز قرار دهید: در برنما مطمئن شوید که شناسه‌های URI هدایت ارائه‌شده را در فهرست مجاز قرار داده‌اید، مشاهده را انتخاب کنید (یا نماد کپی را انتخاب کنید) تا شناسه‌های URI هدایت دقیق مختص برنامه را که برای برنامه متصل‌شده شما تولید شده است بررسی کنید. آن‌ها را به فهرست مجاز سرور OAuth خود اضافه کنید، سپس به «کنسول یکپارچه Google» برگردید.
       2. در بخش انتخاب نحوه اصالت‌سنجی Google با سرور OAuth، نحوه ثبت کارخواه OAuth را انتخاب کنید:
          • پیش‌ثبت‌شده: اگر «شناسه کارخواه» و «رمز کارخواه» (اختیاری) ثابتی در ارائه‌کننده OAuth خود تولید می‌کنید، این گزینه را انتخاب کنید. همچنین می‌توانید به‌صورت اختیاری نقطه پایانی مجوز سفارشی (اختیاری) و نقطه پایانی کد سفارشی (اختیاری) را ارائه دهید.
          • فراداده شناسه کارخواه یا Dynamic Client Registration (توصیه‌شده): اگر سرورتان از OAuth مستندات فراداده شناسه کارخواه (CIMD) یا Dynamic Client Registration‏ (RFC 7591) پشتیبانی می‌کند، این گزینه را انتخاب کنید. Google ابتدا CIMD را بررسی می‌کند و بااستفاده از نقاط پایانی اکتشاف .well-known شما به DCR برمی‌گردد. همچنین می‌توانید به‌طور اختیاری نقاط پایانی کد و مجوز سفارشی را مشخص کنید.

       3. در بخش اصالت‌سنجی با اطلاعات کاربری توسعه‌دهنده، چون مدل مجوزدهی را «واگذارشده به کاربر» انتخاب کرده‌اید، باید به سیستم سرورتان وارد شوید تا Google بتواند ابزارها را واکشی کند. یکی از موارد زیر را انتخاب کنید:

          • اصالت‌سنجی ازطریق «بالاپر» (توصیه‌شده): جریان اصالت‌سنجی را در کادر گفتگوی رونهاد باز می‌کند. این تجربه پیش‌فرض است.
          • Authenticate via Redirect (fallback): جریان اصالت‌سنجی را بااستفاده از هدایت تمام‌صفحه در همان زبانه یا پنجره باز می‌کند. اگر کادر گفتگو به‌دلیل محدودیت‌های نمایش یا سرایندهای امنیتی (مثل X-Frame-Options یا Content-Security-Policy) ارائه نشد، از این گزینه استفاده کنید.

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

       4. ثبت کارخواه (یا به‌روزرسانی کارخواه) را انتخاب کنید.

   توجه: اگر «واگذارشده به کاربر» را به‌عنوان مدل مجوزدهی انتخاب کرده باشید، فقط وقتی ابزارها را واکشی می‌کنیم از شما خواسته می‌شود اصالت‌سنجی کنید. اگر حساب دیگری در حساب توسعه‌دهنده شما روی برنامه متصل‌شده‌تان کار می‌کند، باید قبل‌از همگام‌سازی مجدد ابزارها، اصالت‌سنجی شود.

مرحله ۵: ارائه جزئیات حساب آزمایشی (فقط برای مجوز واگذارشده به کاربر)

اگر برنامه متصل‌شده شما به اصالت‌سنجی نیاز دارد، باید اعتبارنامه آزمایشی ازپیش‌تعیین‌شده‌ای را که با داده‌های نمونه واقع‌گرایانه ازپیش تکمیل شده است و اصالت‌سنجی دوعاملی (2FA) آن غیرفعال است، به‌همراه دستورالعمل‌های آزمایش به نماینده Google خود ارائه دهید. این کار به تیم تضمین کیفیت و بازبینی Google امکان می‌دهد تا اجرای ابزار را بدون مسدود شدن توسط جعبه‌های امن خالی، دیوار پرداخت، یا چالش‌های اصالت‌سنجی دومرحله‌ای درستی‌سنجی کند. اگر Google نتواند برنامه متصل‌شده شما را به‌طور کامل آزمایش کند، ممکن است درطول بررسی رد شود.

مرحله ۶: همگام‌سازی ابزارها

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

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

برای همگام‌سازی ابزارها:

1. در بخش همگام‌سازی ابزارها:

   1. ابزارهای همگام‌سازی را انتخاب کنید.
   2. اگر از شما خواسته شد به سیستم وارد شوید، با حساب توسعه‌دهنده‌ای اصالت‌سنجی کنید که اجازه فهرست کردن همه ابزارهایی را که می‌خواهید دراختیار کاربران قرار دهید داشته باشد. ابزارهایی که حسابتان نمی‌تواند به آن‌ها دسترسی داشته باشد همگام‌سازی نمی‌شوند.
   3. پس‌از اتصال، «کنسول یکپارچه» تعداد ابزارهای همگام‌سازی‌شده را به‌همراه دکمه همگام‌سازی مجدد ابزارها نمایش می‌دهد.
   احتیاط: اگر «کنسول یکپارچه» کارت خطای باید برطرف شود یا خطای اتصال را در زیر کارت همگام‌سازی نمایش می‌دهد، مثلاً فایل‌های کاوش /.well-known/ ناموجود، انواع MIME منبع واسط کاربر پشتیبانی‌نشده، یا اندازه تجمعی منبع واسط کاربر فراتر از حد مجاز، پیش‌از ادامه دادن مشکل را برطرف کنید. برای راه‌حل‌ها، عیب‌یابی ثبت‌نام را ببینید.

2. بعدی را در پایین صفحه انتخاب کنید تا به مرحله ۲ راه‌اندازی MCP و ابزارها بروید.

مرحله ۷: تعیین کنید کاربران چگونه و کجا برنامه شما را تجربه می‌کنند

در بخش ابزارها در صفحه راه‌اندازی کردن MCP و ابزارها، پارامترهای اصلی را پیکربندی کنید، مثلاً اینکه برنامه متصل‌شده شما ازنظر جغرافیایی کجا دردسترس باشد، زبان آن چیست، و می‌خواهید در کدام محصولات Google دردسترس باشد.

1. در بخش دردسترس بودن، در کنار دردسترس قرار دادن نسخه در، گزینه‌های هدف‌یابی زیر را پیکربندی کنید:
   • کشورها / مناطق: مکان‌های جغرافیایی را که می‌خواهید برنامه متصل‌شده شما در آن‌ها دردسترس باشد انتخاب کنید.
   • زبان‌ها: زبان‌هایی را که برنامه متصل‌شده شما پشتیبانی می‌کند انتخاب کنید.
   • محصولات: محصولات Google را که برنامه متصل‌شده شما در آن‌ها دردسترس خواهد بود انتخاب کنید.

2. در بخش ابزارها پس‌از دردسترس بودن، ابزارهای همگام‌سازی‌شده از سرور MCP خود را مرور کنید. هر ابزاری را در فهرست ابزارها انتخاب کنید تا تنظیمات آن را در پانل مدیریت ابزار در سمت چپ پیکربندی کنید:

   • فعال کردن ابزار: کلید فعال کردن ابزار را برای گنجاندن یا نگنجاندن ابزار در برنامه متصل‌شده‌تان تغییر دهید. ابزارهای غیرفعال‌شده در برنامه متصل‌شده‌تان برای تعامل کاربران دردسترس نخواهند بود.

   • بافت اضافی: انتخاب کنید که آیا ابزارتان برای کار کردن به سیگنال‌های بافتی از Google نیاز دارد یا نه:

     • منطقه زبانی: منطقه زبانی که «حساب Google» کاربر تعیین کرده است.
     • مکان تقریبی: مکان فیزیکی کاربر یا دستگاه در منطقه‌ای بزرگ‌تر یا مساوی با ۳ کیلومتر مربع (برای مثال، شهری که کاربر در آن قرار دارد).
     • مکان دقیق: مکان فیزیکی کاربر یا دستگاه با دقت ۵۰ متر یا کمتر.
     احتیاط: نباید بافت اضافی درخواست کنید، مگراینکه الزام و هدف مشخصی وجود داشته باشد. اگر ابزارها بافت بیشتری از آنچه لازم است درخواست کنند، ممکن است برنامه متصل‌شده شما در بازبینی پذیرفته نشود.

   • تأیید کاربر: تأیید کاربر الزامی است را انتخاب کنید تا قبل‌از اجرای ابزار، تأیید صریح کاربر الزامی باشد (اگر حاشیه‌نویسی‌های MCP ابزار شما destructiveHint: true را مشخص کند، این گزینه به‌طور خودکار ازپیش انتخاب می‌شود).

3. اگر سرور MCP شما منابع میانای کاربر ارائه می‌دهد، به برگه منابع میانای کاربر در کنار ابزارها بروید تا منابع میانای کاربر سرورتان (text/html، text/html;profile=mcp-app، text/javascript، text/css) را بررسی کنید، ببینید کدام ابزارها به هر منبع پیوند داده شده‌اند، و «خط‌مشی امنیتی محتوا» (CSP) connectDomains و resourceDomains را مرور کنید.

   توجه: «برنامه‌های MCP» برای «برنامه‌های متصل‌شده» در مرحله بتا است و ممکن است دردسترس نباشد. منابع رابط کاربری که در سرورتان پیدا شده است ممکن است درصورت شناسایی نادیده گرفته شود.

4. ذخیره را در پایین صفحه انتخاب کنید.

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

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

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

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

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

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

   توجه: پس‌از اینکه آزمایش‌کنندگان را اضافه کردید، ممکن است تا ۱۰ دقیقه طول بکشد تا برنامه متصل‌شده شما برای آن حساب‌ها نمایان شود.

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

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

   • همه پیام‌واره‌های نمونه را امتحان کنید.
   • هم فراخوانی‌های صریح @<AppName> و هم پُرسمان‌های زبان طبیعی را آزمایش کنید.
   • جریان اصالت‌سنجی سرتاسر، اجرای ابزار، پیام‌واره‌های تأیید کاربر، و هرگونه منابع واسط کاربر را درستی‌سنجی کنید.
   توجه: همچنین می‌توانید برنامه متصل‌شده خود را در «حالت توسعه‌دهنده برنامه‌های Gemini» اشکال‌زدایی کنید، جایی که می‌توانید سرور «پروتکل بافتار مدل» (MCP) خود را به‌صورت تعاملی آزمایش کنید، خطاهای طرح‌واره یا زمان اجرا را تشخیص دهید، و کیفیت ابزار را قبل‌از ارسال برنامه متصل‌شده خود برای بازبینی در «کنسول متصل‌شده Google» محک بزنید. برای جزئیات، به نمای کلی «حالت توسعه‌دهنده برنامه‌های Gemini» و آزمایش، اشکال‌زدایی، و ارزیابی در «حالت توسعه‌دهنده برنامه‌های Gemini» مراجعه کنید. مطمئن شوید که با یک حساب به سیستم Gemini وارد شده‌اید.

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

مرحله ۹: بازبینی برنامه متصل‌شده‌تان را آغاز کنید و پس‌از تأیید آن را منتشر کنید

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

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

1. در صفحه نمای کلی برنامه متصل‌شده، در کارت نسخه‌های پخش در سمت راست صفحه، ارسال برای بازبینی را انتخاب کنید (وقتی پیکربندی برنامه‌تان تکمیل شود و در نسخه پیش‌نمایش بدون مشکل مسدودکننده باشد، فعال می‌شود).

2. وقتی نسخه‌تان دردست بررسی است:

   • «کنسول متصل» به‌طور خودکار نسخه پیش‌نویس قابل‌ویرایش جدیدی ایجاد می‌کند تا آزمایش‌کنندگان بتوانند به پیش‌دید برنامه شما ادامه دهند و شما بتوانید ویرایش‌های آتی را بدون ایجاد اختلال در بازبینی آماده کنید.
   • هرگونه تغییر در نسخه دردست بازبینی را قفل می‌کند.
   • برای مشاهده جزئیات فقط خواندنی نسخه درحال بررسی یا لغو کردن بررسی، دکمه گزینه‌های بیشتر (⋮) را در کارت درحال بررسی انتخاب کنید و مشاهده جزئیات برنامه یا لغو کردن بررسی را انتخاب کنید.

3. وقتی Google بازبینی را تکمیل کرد، اعلانی دریافت خواهید کرد و کارت نسخه‌های پخش به‌روز خواهد شد:

   • اگر مشکلی پیدا شود: کارت نسخه‌های پخش مشکلات پیدا شد را نمایش می‌دهد. مشاهده مشکلات را انتخاب کنید تا یافته‌های خاص بازبینی را بررسی کنید. پیکربندی یا سرور MCP را در نسخه پیش‌نمایش قابل‌ویرایش به‌روز کنید، اصلاحات را با آزمایش‌کنندگان تأیید کنید، و دوباره ارسال برای بازبینی را انتخاب کنید.
   • اگر تأیید شود: کارت نسخه‌های پخش وضعیت آماده انتشار را نشان می‌دهد. وقتی برای انتشار برنامه متصل‌شده برای کاربران آماده بودید، انتشار را انتخاب کنید.

تبریک! برنامه متصل‌شده شما اکنون منتشر شده است و برای کاربران در سراسر محصولات Google انتخابی‌تان عرضه می‌شود.

مدیریت نسخه پس‌از انتشار و مستمر

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

درحالی‌که نسخه منتشرشده شما در محیط تولید فعال باقی می‌ماند، می‌توانید از پانل ویرایش و آزمایش برنامه متصل‌شده در سمت راست استفاده کنید (یا اگر پیش‌نویسی وجود ندارد، ایجاد نسخه جدید را انتخاب کنید) تا به‌روزرسانی‌ها را در نسخه جدید (Version <N+1>) به‌طور مستقل پیکربندی، پیش‌دید، و آزمایش کنید و سپس آن را برای بازبینی و انتشار ارسال کنید.

نکته: هر ورودی برنامه متصل‌شده یک نشانی وب نقطه پایان MCP دارد. برای آزمایش تغییرات درحال انجام درمقابل نشانی وب سرور MCP آماده‌سازی جداگانه پس‌از راه‌اندازی بدون تأثیر بر پیکربندی نقطه پایان تولید، از «حالت توسعه‌دهنده Gemini» استفاده کنید یا یک برنامه متصل‌شده آماده‌سازی اختصاصی جداگانه ثبت کنید که در پیش‌نمایش نگهداری می‌شود (دردسترس آزمایش‌کنندگان).