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

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

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

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

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

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

ایجاد یک پروژه ابری جدید و فعال کردن APIها برای برنامه چت در سازمان ادغام‌شده Google Workspace تضمین می‌کند که کاربران و گروه‌هایی که به آنها اجازه دسترسی به برنامه چت را می‌دهید، می‌توانند بدون خطا این کار را انجام دهند.

ایجاد یک پروژه ابری

کنسول گوگل کلود

  1. در کنسول گوگل کلود، به Menu > IAM & Admin > Create a Project بروید.

    به ایجاد پروژه بروید

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

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

  3. در فیلد «مکان» ، روی «مرور» کلیک کنید تا مکان‌های بالقوه برای پروژه شما نمایش داده شود. سپس، روی «انتخاب» کلیک کنید.
  4. روی ایجاد کلیک کنید. کنسول Google Cloud به صفحه داشبورد هدایت می‌شود و پروژه شما ظرف چند دقیقه ایجاد می‌شود.

رابط خط فرمان جی‌کلاود

در یکی از محیط‌های توسعه زیر، به رابط خط فرمان گوگل کلود ( gcloud ) دسترسی پیدا کنید:

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

فعال کردن APIها

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

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

کنسول گوگل کلود

  1. در کنسول گوگل کلود، به منو > مشاهده همه محصولات > سایر محصولات گوگل > فضای کاری گوگل > کتابخانه محصولات بروید.

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

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

رابط خط فرمان ابری گوگل

  1. رابط خط فرمان (CLI) گوگل کلود را نصب یا باز کنید.

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

    gcloud services enable API_SERVICE_ID

پیکربندی API چت

در پروژه ابری جدید خود، باید از Chat API برای مشخص کردن نام، توضیحات و آیکون برنامه چت خود استفاده کنید. برای پیکربندی این جزئیات، به پیکربندی Chat API مراجعه کنید.

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

  1. در کنسول گوگل کلود، به Menu > برویدGoogle Auth platform > برندسازی .

    به بخش برندسازی بروید

  2. اگر قبلاً تنظیمات را انجام داده‌اید Google Auth platformمی‌توانید تنظیمات صفحه رضایت OAuth زیر را در Branding ، Audience و Data Access پیکربندی کنید. اگر پیامی با این مضمون مشاهده کردید Google Auth platform هنوز پیکربندی نشده است ، روی شروع کار کلیک کنید:
    1. در بخش اطلاعات برنامه ، در قسمت نام برنامه ، نام برنامه را وارد کنید.
    2. در ایمیل پشتیبانی کاربر ، یک آدرس ایمیل پشتیبانی انتخاب کنید که کاربران در صورت داشتن هرگونه سوال در مورد رضایت خود بتوانند با شما تماس بگیرند.
    3. روی بعدی کلیک کنید.
    4. در قسمت مخاطبان ، نوع کاربر برنامه خود را انتخاب کنید.
    5. روی بعدی کلیک کنید.
    6. در قسمت اطلاعات تماس ، یک آدرس ایمیل وارد کنید که از طریق آن بتوانید از هرگونه تغییر در پروژه خود مطلع شوید.
    7. روی بعدی کلیک کنید.
    8. در قسمت Finish ، سیاست داده‌های کاربر سرویس‌های API گوگل را مرور کنید و در صورت موافقت، گزینه «من با سیاست‌های داده‌های کاربر سرویس‌های API گوگل موافقم» را انتخاب کنید.
    9. روی ادامه کلیک کنید.
    10. روی ایجاد کلیک کنید.
    11. اگر نوع کاربر را External انتخاب کرده‌اید، کاربران آزمایشی را اضافه کنید:
      1. روی مخاطب کلیک کنید.
      2. در قسمت کاربران آزمایشی ، روی افزودن کاربران کلیک کنید.
      3. آدرس ایمیل خود و سایر کاربران آزمایشی مجاز را وارد کنید، سپس روی ذخیره کلیک کنید.

  3. اگر در حال ایجاد برنامه‌ای برای استفاده در خارج از سازمان Google Workspace خود هستید، روی دسترسی به داده‌ها > افزودن یا حذف محدوده‌ها کلیک کنید. هنگام انتخاب محدوده‌ها، بهترین شیوه‌های زیر را توصیه می‌کنیم:

    • محدوده‌هایی را انتخاب کنید که حداقل سطح دسترسی مورد نیاز برنامه شما را فراهم می‌کنند. برای مشاهده فهرست محدوده‌های موجود، به محدوده‌های OAuth 2.0 برای APIهای گوگل مراجعه کنید.
    • دامنه‌های ذکر شده در هر یک از سه بخش را بررسی کنید: دامنه‌های غیر حساس، دامنه‌های حساس و دامنه‌های محدود شده. برای هر دامنه‌ای که در بخش‌های «دامنه‌های حساس شما» یا «دامنه‌های محدود شده شما» ذکر شده است، سعی کنید دامنه‌های غیر حساس جایگزین را شناسایی کنید تا از بررسی‌های اضافی غیرضروری جلوگیری شود.
    • برخی از محدوده‌ها نیاز به بررسی‌های بیشتر توسط گوگل دارند. برای برنامه‌هایی که فقط به صورت داخلی توسط سازمان Google Workspace شما استفاده می‌شوند، محدوده‌ها در صفحه رضایت فهرست نمی‌شوند و استفاده از محدوده‌های محدود یا حساس نیازی به بررسی بیشتر توسط گوگل ندارد. برای اطلاعات بیشتر، به دسته‌های محدوده مراجعه کنید.
  4. پس از انتخاب محدوده‌های مورد نیاز برنامه، روی ذخیره کلیک کنید.

برای اطلاعات بیشتر در مورد پیکربندی رضایت OAuth، به بخش «شروع به کار با» مراجعه کنید. Google Auth platform .

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

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

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

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

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

پیکربندی ویژگی‌های تعاملی در پروژه جدید Cloud

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

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

استقرار مجدد یک برنامه چت با اسکریپت برنامه‌ها

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

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

  1. در کنسول گوگل کلود، به Menu > IAM & Admin > Settings بروید.

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

  2. در فیلد شماره پروژه ، مقدار را کپی کنید.

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

  1. به اسکریپت برنامه‌ها بروید.

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

  2. در پروژه‌ی اسکریپت برنامه‌های چت، پروژه کلیک کنید.

  3. در زیر پروژه پلتفرم ابری گوگل (GCP) ، روی تغییر پروژه کلیک کنید.

  4. در قسمت شماره پروژه GCP ، شماره پروژه Google Cloud را وارد کنید.

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

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

  1. در بالا سمت راست Apps Script، روی Deploy > Manage deployments کلیک کنید.
  2. در زیر شناسه استقرار ، روی کپی کلیک کنید.
  3. روی انجام شد کلیک کنید.

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

  1. در کنسول گوگل کلود، عبارت «Google Chat API» را جستجو کنید و روی Google Chat API کلیک کنید، سپس روی مدیریت کلیک کنید.

    به API چت بروید

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

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

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

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

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

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

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

یک برنامه چت AppSheet را مجدداً مستقر کنید

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

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

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

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

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

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

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

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

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

    رفتن به چت

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

  3. روی منوی کشویی کنار نام فضا یا شخص کلیک کنید و سپس برنامه‌ها و ادغام‌ها را انتخاب کنید.

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

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

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

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

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

    رفتن به چت

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

  3. روی منوی کشویی کنار نام فضا یا شخص کلیک کنید و سپس برنامه‌ها و ادغام‌ها را انتخاب کنید.

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

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

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

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