برنامه Google Chat خود را انتقال دهید

اگر سازمان‌های Google Workspace را ادغام کنید، شاید لازم باشد برنامه چت خود را منتقل کنید تا به کار خود ادامه دهد.

قبل از انتقال برنامه چت، با سرپرست سازمانتان مشورت کنید تا ببینید آیا تنظیمات مدیریتی روی آن تأثیر می‌گذارند یا خیر. تغییر تنظیمات اداری ممکن است عملکرد کامل را به برنامه چت شما بازگرداند و انتقال را غیرضروری کند. به عنوان مثال، ممکن است سرپرست Google Workspace شما مجبور شود برنامه Chat شما را به فهرست مجاز اضافه کند یا ممکن است به کاربران اجازه دهد برنامه‌های Chat را نصب کنند. برای اطلاعات بیشتر، به تعیین اینکه آیا برنامه‌های گپ Google باید پس از ادغام سازمان‌های Google Workspace مهاجرت کنند، مراجعه کنید.

پس از اینکه تشخیص دادید که باید برنامه چت خود را منتقل کنید، فرآیند سه مرحله ای زیر را تکمیل کنید:

  1. با ایجاد یک پروژه Google Cloud در سازمان ادغام شده، فعال کردن APIها و پیکربندی احتمالی صفحه رضایت OAuth 2.0، محیط را برای برنامه Chat خود تنظیم کنید.
  2. برنامه Chat خود را از پروژه جدید Cloud مجدداً مستقر کنید.
  3. برنامه Chat بازسازی شده را به فضاهای چت یا مکالمات اضافه کنید و برنامه اصلی Chat را خاموش کنید.

یک پروژه Cloud در سازمان ادغام شده ایجاد کنید و API ها را فعال کنید

ایجاد یک پروژه Cloud جدید و فعال کردن APIها برای برنامه Chat در سازمان ادغام شده Google Workspace اطمینان حاصل می کند که کاربران و گروه هایی که به آنها اجازه دسترسی به برنامه Chat را می دهید می توانند این کار را بدون خطا انجام دهند.

یک پروژه Cloud ایجاد کنید

کنسول Google Cloud

  1. در کنسول Google Cloud، به منو > IAM & Admin > ایجاد پروژه بروید.

    به Create a Project بروید

  2. در قسمت Project Name یک نام توصیفی برای پروژه خود وارد کنید.

    اختیاری: برای ویرایش شناسه پروژه ، روی ویرایش کلیک کنید. شناسه پروژه پس از ایجاد پروژه قابل تغییر نیست، بنابراین شناسه ای را انتخاب کنید که نیازهای شما را برای طول عمر پروژه برآورده کند.

  3. در قسمت Location ، روی Browse کلیک کنید تا مکان های احتمالی پروژه شما نمایش داده شود. سپس، روی انتخاب کلیک کنید.
  4. روی ایجاد کلیک کنید. کنسول Google Cloud به صفحه داشبورد می رود و پروژه شما در عرض چند دقیقه ایجاد می شود.

gcloud CLI

در یکی از محیط‌های توسعه زیر، به Google Cloud CLI («gcloud») دسترسی پیدا کنید:

  • Cloud Shell : برای استفاده از ترمینال آنلاین با Gcloud CLI که قبلاً راه اندازی شده است، Cloud Shell را فعال کنید.
    Cloud Shell را فعال کنید
  • Local Shell : برای استفاده از یک محیط توسعه محلی، gcloud CLI را نصب و مقداردهی اولیه کنید .
    برای ایجاد یک پروژه Cloud، از دستور 'gcloud projects create' استفاده کنید: 
    gcloud projects create PROJECT_ID
    با تنظیم ID برای پروژه ای که می خواهید ایجاد کنید، PROJECT_ID را جایگزین کنید.

API ها را فعال کنید

همه برنامه‌های چت باید Google Chat API را فعال کنند. بسته به نحوه ساخت برنامه چت شما، ممکن است لازم باشد API های دیگری را فعال کنید. برای مثال، اگر برنامه چت خود را با استفاده از Google Cloud Functions ساخته‌اید ، API Cloud Build، Cloud Functions API، Pub/Sub API، Cloud Logging API، Artifact Registry API و Cloud Run API را فعال کنید. به عنوان بهترین روش، برای اطمینان از کارکرد برنامه مهاجرت شده، همان APIهایی را در پروژه جدید Cloud فعال کنید که در پروژه Cloud قدیمی فعال هستند.

برای فعال کردن یک API، موارد زیر را انجام دهید:

کنسول Google Cloud

  1. در کنسول Google Cloud، به منو > محصولات بیشتر > Google Workspace > کتابخانه محصول بروید.

    به کتابخانه محصول بروید

  2. روی API که می‌خواهید روشن شود کلیک کنید.
  3. روی Enable کلیک کنید.
  4. برای فعال کردن API های بیشتر، این مراحل را تکرار کنید.

Google Cloud CLI

  1. رابط خط فرمان Google Cloud (CLI) را نصب یا باز کنید.

  2. دستور services enable اجرا کنید و مشخص کنید کدام سرویس API فعال شود.

    gcloud services enable API_SERVICE_ID

ممکن است لازم باشد صفحه رضایت OAuth را برای پروژه Cloud خود پیکربندی کنید. اگر قبلاً از OAuth 2.0 برای مجوز استفاده کرده‌اید، از همان محدوده دسترسی استفاده کنید.

  1. در کنسول Google Cloud، به منو > APIs & Services > صفحه رضایت OAuth بروید.

    به صفحه رضایت OAuth بروید

  2. نوع کاربری برنامه خود را انتخاب کنید، سپس روی ایجاد کلیک کنید.
  3. فرم ثبت نام برنامه را تکمیل کنید، سپس روی ذخیره و ادامه کلیک کنید.

  4. اگر برنامه‌ای را برای استفاده خارج از سازمان Google Workspace خود ایجاد می‌کنید، روی Add or Remove Scopes کلیک کنید. ما بهترین روش های زیر را هنگام انتخاب محدوده توصیه می کنیم:

    • محدوده هایی را انتخاب کنید که حداقل سطح دسترسی مورد نیاز برنامه شما را فراهم می کند. برای فهرستی از حوزه‌های موجود، OAuth 2.0 Scopes for Google APIs را ببینید.
    • محدوده های فهرست شده در هر یک از سه بخش را مرور کنید: محدوده های غیر حساس، محدوده های حساس، و محدوده های محدود. برای هر حوزه‌ای که در بخش‌های «حوزه‌های حساس شما» یا «حوزه‌های محدود شما» فهرست شده‌اند، سعی کنید محدوده‌های غیرحساس جایگزین را شناسایی کنید تا از بررسی‌های اضافی غیرضروری خودداری کنید.
    • برخی از حوزه‌ها نیاز به بررسی بیشتر توسط Google دارند. برای برنامه‌هایی که فقط به صورت داخلی توسط سازمان Google Workspace شما استفاده می‌شوند، دامنه‌ها در صفحه رضایت فهرست نشده‌اند و استفاده از محدوده‌های محدود یا حساس نیازی به بررسی بیشتر توسط Google ندارد. برای اطلاعات بیشتر، به دسته‌های محدوده مراجعه کنید.
  5. پس از انتخاب محدوده های مورد نیاز برنامه خود، روی ذخیره و ادامه کلیک کنید.
  6. اگر خارجی را برای نوع کاربر انتخاب کرده اید، کاربران آزمایشی را اضافه کنید:
    1. در بخش تست کاربران ، روی افزودن کاربران کلیک کنید.
    2. آدرس ایمیل خود و سایر کاربران آزمایشی مجاز را وارد کنید، سپس روی ذخیره و ادامه کلیک کنید.
  7. خلاصه ثبت برنامه خود را مرور کنید. برای ایجاد تغییرات، روی ویرایش کلیک کنید. اگر ثبت برنامه خوب به نظر می رسد، روی بازگشت به داشبورد کلیک کنید.

برنامه چت خود را مجدداً در پروژه جدید Cloud قرار دهید

بسته به اینکه برنامه چت شما با Apps Script، AppSheet یا نوع اتصال دیگری مانند Python یا Java ساخته شده باشد، استقرار مجدد برنامه Chat کمی متفاوت است. در هر صورت، نیازی نیست که همه کدهای خود را دوباره ایجاد کنید، اما باید تغییراتی ایجاد کنید.

منطق برنامه چت را منتقل کنید

بسته به معماری برنامه Chat خود ، ممکن است نیاز باشد خدمات دیگری را به پروژه جدید Cloud منتقل کنید:

  • برای برنامه‌های HTTP، باید بقیه منطق برنامه را که با استفاده از توابع Cloud، Cloud Run یا App Engine ساخته شده است، منتقل کنید.
  • برای برنامه‌های گفتگوی چت که از زبان طبیعی استفاده می‌کنند، باید عوامل Dialogflow را نیز منتقل کنید.
  • برای برنامه‌های چت که پشت فایروال ساخته شده‌اند، باید موضوعات Pub/Sub را نیز منتقل کنید.

برنامه Chat را در پروژه جدید Cloud پیکربندی کنید

برای استقرار مجدد برنامه Chat خود که با زبانی مانند Python یا Java ساخته شده است، برنامه Chat را در پروژه Cloud جدید خود پیکربندی کنید.

  1. در کنسول Google Cloud، «Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی Manage کلیک کنید.

    به Chat API بروید

  2. روی تب Configuration کلیک کنید و اطلاعات مورد نیاز زیر را وارد کنید:

    • نام برنامه : نامی که افراد هنگام تعامل با برنامه چت شما از آن استفاده می کنند.
    • نشانی وب آواتار : نشانی اینترنتی HTTPS که به تصویر گرافیکی مربعی (مثلاً PNG یا JPEG)، حداقل ۱۲۸×۱۲۸ اشاره می‌کند که به‌عنوان نماد برنامه چت شما ظاهر می‌شود.
    • توضیحات : شرحی از هدف برنامه چت که در زیر نام برنامه چت شما ظاهر می شود.

  3. برای روشن کردن ویژگی‌های تعاملی، روی کلید فعال کردن ویژگی‌های تعاملی کلیک کنید تا کاربران با برنامه چت شما تعامل داشته باشند و از جدول زیر برای تکمیل پیکربندی استفاده کنند:

    رشته شرح
    عملکرد مجموعه‌ای از فیلدها که نحوه تعامل برنامه چت با کاربران را تعیین می‌کند:
    • دریافت پیام‌های ۱:۱ : کاربران می‌توانند برنامه چت را مستقیماً در چت Google پیدا کنند و پیام دهند.
    • پیوستن به فضاها و مکالمات گروهی : کاربران می توانند برنامه چت را به فضاها و مکالمات گروهی اضافه کنند.
    تنظیمات اتصال نقطه پایانی برای برنامه Chat که یکی از موارد زیر است:
    • URL برنامه : یک نقطه پایانی HTTPS که اجرای برنامه Chat را میزبانی می کند.
    • پروژه Apps Script : شناسه استقرار برای پروژه Apps Script که یک برنامه Chat را پیاده سازی می کند.
    • نام موضوع Cloud Pub/Sub : یک موضوع Pub/Sub که برنامه Chat به عنوان نقطه پایانی در آن مشترک شده است.
    • Dialogflow : برنامه Chat را با یکپارچه سازی Dialogflow ثبت می کند. برای اطلاعات بیشتر، به ساخت برنامه گفتگوی Google Chat که زبان طبیعی را می‌فهمد، مراجعه کنید.
    دستورات اسلش دستوراتی که می توانند برای کاربران در چت Google ظاهر شوند. به کاربران اجازه می‌دهد تا عملکردهای اصلی برنامه چت شما را در Google Chat ببینند و اقدام خاصی را که می‌خواهند با آن تعامل داشته باشند انتخاب کنند. برای اطلاعات بیشتر، پاسخ به دستورات اسلش را به‌عنوان برنامه چت ببینید.
    پیش نمایش پیوندها الگوهای نشانی وب که برنامه چت می شناسد و محتوای اضافی را برای زمانی که کاربران پیوند می فرستند ارائه می کند. برای اطلاعات بیشتر، پیش‌نمایش پیوندها را ببینید.
    دید حداکثر 5 نفر یا یک یا چند گروه Google که می‌توانند برنامه چت شما را مشاهده و نصب کنند. از این فیلد برای آزمایش برنامه چت یا اشتراک گذاری برنامه چت با تیم خود استفاده کنید. برای اطلاعات بیشتر، تنظیمات مشاهده و انتشار را برای برنامه گپ خود ببینید.

  4. برای ثبت خطاها در Cloud Logging هر زمان که برنامه Chat خطایی را برمی‌گرداند، کادر انتخاب Log errors to Logging را انتخاب کنید. برای اطلاعات بیشتر، به گزارش‌های خطای درخواست برای برنامه‌های گپ مراجعه کنید.

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

یک برنامه Apps Script Chat را مجدداً راه اندازی کنید

برای استقرار مجدد برنامه Chat خود که با Apps Script ساخته شده است، شماره پروژه Cloud را که پروژه Apps Script با آن مرتبط است به شماره پروژه متعلق به پروژه Cloud جدید خود تغییر دهید. سپس، شناسه استقرار Apps Script خود را کپی کنید و آن را در صفحه پیکربندی برنامه Chat در کنسول Google Cloud جای‌گذاری کنید.

شماره پروژه Cloud خود را کپی کنید

  1. در کنسول Google Cloud، به منو > IAM & Admin > تنظیمات بروید.

    به تنظیمات IAM و Admin بروید

  2. در قسمت Project number مقدار را کپی کنید.

شماره پروژه Google Cloud خود را در پروژه Apps Script خود تنظیم کنید

  1. به Apps Script بروید.

    به Apps Script بروید

  2. در پروژه برنامه Chat Apps Script، روی تنظیمات پروژه کلیک کنید.

  3. در پروژه Google Cloud Platform (GCP) ، روی تغییر پروژه کلیک کنید.

  4. در شماره پروژه GCP ، شماره پروژه Google Cloud را جای‌گذاری کنید.

  5. روی تنظیم پروژه کلیک کنید.

شناسه استقرار پروژه Apps Script خود را کپی کنید

  1. در سمت راست بالای Apps Script، روی Deploy > Manage Deployments کلیک کنید.
  2. در قسمت Deployment ID ، روی Copy کلیک کنید.
  3. روی Done کلیک کنید.

برنامه چت خود را مجدداً پیکربندی و راه اندازی کنید

  1. در کنسول Google Cloud، «Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی Manage کلیک کنید.

    به Chat API بروید

  2. روی تب Configuration کلیک کنید و اطلاعات مورد نیاز زیر را وارد کنید:

    • نام برنامه : نامی که افراد هنگام تعامل با برنامه چت شما از آن استفاده می کنند.
    • نشانی وب آواتار : نشانی اینترنتی HTTPS که به تصویر گرافیکی مربعی (مثلاً PNG یا JPEG)، حداقل ۱۲۸×۱۲۸ اشاره می‌کند که به‌عنوان نماد برنامه چت شما ظاهر می‌شود.
    • توضیحات : شرحی از هدف برنامه چت که در زیر نام برنامه چت شما ظاهر می شود.

  3. برای روشن کردن ویژگی‌های تعاملی، روی کلید فعال کردن ویژگی‌های تعاملی که به کاربران اجازه می‌دهد با برنامه چت شما تعامل داشته باشند، کلیک کنید:

  4. در قسمت تنظیمات اتصال، پروژه Apps Script را انتخاب کنید.

  5. در قسمت Deployment ID ، شناسه استقرار را که قبلاً کپی کرده‌اید، قرار دهید.

  6. برای تکمیل بقیه تنظیمات، جدول را در پیکربندی برنامه چت در پروژه جدید Cloud ببینید.

  7. روی ذخیره کلیک کنید.

یک برنامه AppSheet Chat را مجدداً راه اندازی کنید

برای استقرار مجدد برنامه Chat خود که با AppSheet در پروژه جدید Cloud شما ساخته شده است، برنامه را در پروژه جدید Cloud کپی کنید .

حساب سرویس را به روز کنید

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

برنامه چت خود را به اشتراک بگذارید

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

به برنامه جدید چت بروید

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

برنامه جدید چت را به فضاهای چت اضافه کنید

  1. به چت بروید.

    به چت بروید

  2. روی پیام یا فاصله مستقیم کلیک کنید.

  3. روی منوی کشویی کنار نام فضا یا شخص کلیک کنید و سپس Apps & Integrations را انتخاب کنید.

  4. روی افزودن برنامه ها کلیک کنید.

  5. نام برنامه را وارد کنید، برنامه را از لیست انتخاب کنید و سپس روی افزودن کلیک کنید.

  6. این مراحل را برای هر فضا یا پیام مستقیمی که می‌خواهید برنامه چت را به آن اضافه کنید، تکرار کنید.

برنامه قدیمی چت را از فضاهای چت حذف کنید

  1. به چت بروید.

    به چت بروید

  2. روی پیام یا فاصله مستقیم کلیک کنید.

  3. روی منوی کشویی کنار نام فضا یا شخص کلیک کنید و سپس Apps & Integrations را انتخاب کنید.

  4. در کنار برنامه چت قدیمی و مهاجرت‌نشده، روی گزینه‌های بیشتر کلیک کنید و سپس روی حذف از فضا کلیک کنید.

  5. این مراحل را برای هر فضا یا پیام مستقیمی که می‌خواهید برنامه قدیمی چت را از آن حذف کنید، تکرار کنید.

برنامه قدیمی چت را خاموش کنید

برای جلوگیری از استفاده کاربران از برنامه چت قدیمی و تشویق آنها به استفاده از برنامه گپ جدید، برنامه گپ قدیمی را خاموش کنید و انتشار آن را از Google Workspace Marketplace لغو کنید .