یک افزونه Meet راه اندازی کنید

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

ایجاد یک پروژه گوگل کلود

برای ایجاد یک پروژه Google Cloud، به ایجاد یک پروژه Google Cloud مراجعه کنید.

فعال کردن SDK بازار Google Workspace و API افزونه‌های Google Workspace

برای توسعه افزونه‌های Meet، به SDK بازار و رابط برنامه‌نویسی کاربردی افزونه‌های Google Workspace نیاز است. برای فعال کردن آنها:

  1. کنسول گوگل کلود را باز کنید.
  2. در بالا، اگر پروژه‌ی دیگری از قبل باز است، نام پروژه‌ی برنامه‌ی خود را برای تغییر پروژه‌ها انتخاب کنید.
  3. در بالا، در نوار جستجو، عبارت Google Workspace Marketplace SDK تایپ کنید و اینتر را بزنید.
  4. صفحه Google Workspace Marketplace SDK باز کنید، روی فعال کردن کلیک کنید.

  5. برای یافتن و فعال کردن Google Workspace add-ons API این مراحل را تکرار کنید.

ایجاد یک استقرار

برای استفاده از یک افزونه در Meet، به یک فایل استقرار و یک فایل مانیفست افزونه نیاز دارید.

  1. کنسول گوگل کلود را باز کنید.
  2. در بالا، اگر پروژه‌ی دیگری از قبل باز است، نام پروژه‌ی برنامه‌ی خود را برای تغییر پروژه‌ها انتخاب کنید.
  3. روی APIها و سرویس‌ها کلیک کنید.
  4. برای مشاهده صفحه جزئیات، Google Workspace Marketplace SDK انتخاب کنید.

استقرار خود را ایجاد کنید

شما می‌توانید با ایجاد یک استقرار HTTP (توصیه می‌شود) یا با استفاده از اسکریپت برنامه‌های گوگل، استقرار خود را مستقیماً در کنسول Google Cloud ایجاد کنید.

استقرار HTTP

  1. روی برگه استقرار HTTP کلیک کنید.
  2. روی ایجاد استقرار جدید کلیک کنید و شناسه استقرار افزونه را وارد کنید.

    شناسه استقرار یک رشته دلخواه است که به توسعه‌دهنده افزونه کمک می‌کند تا استقرار حاوی مانیفست افزونه را شناسایی کند. شناسه‌های استقرار الزامی هستند و می‌توانند حداکثر ۱۰۰ کاراکتر داشته باشند.

  3. روی بعدی کلیک کنید.

    یک پنل کناری برای شما باز می‌شود تا مشخصات مانیفست افزونه را در قالب JSON ارسال کنید. به این حالت DEPLOYMENT.JSON نیز گفته می‌شود.

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

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUrl": "SIDE_PANEL_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING,
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "logoUrl": "MEET_WEB_LOGO_URL",
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL"
          }
        }
      }
    }
    

    موارد زیر را جایگزین کنید:

    • NAME : رشته. نام افزونه‌ی گوگل میت شما.
    • LOGO_URL : رشته. نشانی اینترنتی لوگوی افزونه‌ی Google Workspace. این برای افزونه در سراسر محصولات Google Workspace استفاده می‌شود.
    • SIDE_PANEL_URL : رشته. آدرس اینترنتی (URL) به نقطه ورود برنامه افزونه شما. این آدرس در یک iframe در پنل کناری نمایش داده می‌شود. مبدا این URL باید بخشی از مبداهای مشخص شده در فیلد ADD_ON_ORIGINS باشد.
    • SUPPORTS_SCREENSHARING : اختیاری. از نوع بولی. اگر روی false تنظیم شود، کاربران باید از افزونه برای دیدن اتفاقات یک جلسه افزونه مشارکتی استفاده کنند. اگر روی true تنظیم شود، آغازگر جلسه افزونه مشارکتی می‌تواند نمای خود از افزونه را به اشتراک بگذارد.
    • ADD_ON_ORIGINS : فهرست رشته‌ها. فهرستی از مبدأهایی که افزونه شما در آنها میزبانی می‌شود. دو URL زمانی که طرح، میزبان و پورت یکسانی داشته باشند، مبدأ یکسانی دارند. زیرمبدأها و همچنین زیردامنه‌های wildcard نیز مجاز هستند. برای اطلاعات بیشتر، به امنیت افزونه مراجعه کنید.
    • MEET_WEB_LOGO_URL : اختیاری. رشته. یک URL مخصوص Meet از لوگوی افزونه. این لوگو در سراسر Meet استفاده می‌شود. در صورت عدم وجود، از logoUrl از بخش مشترک استفاده می‌شود. برای دستورالعمل‌های طراحی لوگو، به بهترین شیوه‌ها مراجعه کنید.
    • DARK_MODE_LOGO_URL : رشته. یک URL مخصوص حالت تاریک برای لوگوی افزونه. ارائه یک لوگوی حالت تاریک تضمین می‌کند که افزونه شما در هر قالب Meet به بهترین شکل ظاهر شود. برای دستورالعمل‌های طراحی لوگو، به «بهترین شیوه‌ها» مراجعه کنید.
  4. روی ارسال کلیک کنید.

    برای اطلاعات بیشتر در مورد استقرارها، به ایجاد یک منبع استقرار مراجعه کنید.

  5. در برگه پیکربندی برنامه ، در زیر بخش ادغام برنامه ، افزونه Google Workspace را انتخاب کنید. گزینه Deploy using cloud deployment resource را انتخاب کنید و سپس HTTP deployment صحیح را انتخاب کنید.

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

  1. روی برگه پیکربندی برنامه کلیک کنید.

  2. در بخش ادغام برنامه ، افزونه Google Workspace را انتخاب کنید. گزینه Deploy using Google Apps Script deployment ID را انتخاب کنید و شناسه استقرار اسکریپت خود را وارد کنید.

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

    برای جزئیات بیشتر در مورد نحوه ایجاد یک پروژه Apps Script، به مستندات Apps Script مراجعه کنید. افزونه Meet صرفاً به فایل manifest مربوط به appsscript.json که manifest پروژه Apps Script نیز نامیده می‌شود، متکی است. مطمئن شوید که فایل manifest در پروژه Apps Script شما حاوی addOns و بخش meet باشد.

    نمونه کد زیر فیلدهای موجود Meet را در فایل مانیفست افزونه نشان می‌دهد.

    {
      "addOns": {
        "common": {
          "name": "NAME",
          "logoUrl": "LOGO_URL"
        },
        "meet": {
          "web": {
            "sidePanelUrl": "SIDE_PANEL_URL",
            "supportsScreenSharing": SUPPORTS_SCREENSHARING,
            "addOnOrigins": ["ADD_ON_ORIGINS"],
            "logoUrl": "MEET_WEB_LOGO_URL",
            "darkModeLogoUrl": "DARK_MODE_LOGO_URL"
          }
        }
      }
    }
    

    موارد زیر را جایگزین کنید:

    • NAME : رشته. نام افزونه‌ی گوگل میت شما.
    • LOGO_URL : رشته. نشانی اینترنتی لوگوی افزونه‌ی Google Workspace. این برای افزونه در سراسر محصولات Google Workspace استفاده می‌شود.
    • SIDE_PANEL_URL : رشته. آدرس اینترنتی (URL) به نقطه ورود برنامه افزونه شما. این آدرس در یک iframe در پنل کناری نمایش داده می‌شود. مبدا این URL باید بخشی از مبداهای مشخص شده در فیلد ADD_ON_ORIGINS باشد.
    • SUPPORTS_SCREENSHARING : اختیاری. از نوع بولی. اگر روی false تنظیم شود، کاربران باید از افزونه برای دیدن اتفاقات یک جلسه افزونه مشارکتی استفاده کنند. اگر روی true تنظیم شود، آغازگر جلسه افزونه مشارکتی می‌تواند نمای خود از افزونه را به اشتراک بگذارد.
    • ADD_ON_ORIGINS : فهرست رشته‌ها. فهرستی از مبدأهایی که افزونه شما در آنها میزبانی می‌شود. دو URL زمانی که طرح، میزبان و پورت یکسانی داشته باشند، مبدأ یکسانی دارند. زیرمبدأها و همچنین زیردامنه‌های wildcard نیز مجاز هستند. برای اطلاعات بیشتر، به امنیت افزونه مراجعه کنید.
    • MEET_WEB_LOGO_URL : اختیاری. رشته. یک URL مخصوص Meet از لوگوی افزونه. این لوگو در سراسر Meet استفاده می‌شود. در صورت عدم وجود، از logoUrl از بخش مشترک استفاده می‌شود. برای دستورالعمل‌های طراحی لوگو، به بهترین شیوه‌ها مراجعه کنید.
    • DARK_MODE_LOGO_URL : رشته. یک URL مخصوص حالت تاریک برای لوگوی افزونه. ارائه یک لوگوی حالت تاریک تضمین می‌کند که افزونه شما در هر قالب Meet به بهترین شکل ظاهر شود. برای دستورالعمل‌های طراحی لوگو، به «بهترین شیوه‌ها» مراجعه کنید.

افزونه را در Meet نصب و آزمایش کنید

برای آزمایش افزونه‌تان در Meet، ابتدا باید آن را برای کاربر وارد شده نصب کنید:

استقرار HTTP

  1. در کنسول گوگل کلود، به SDK بازار فضای کاری گوگل برای پروژه خود بروید .
  2. روی برگه استقرار HTTP کلیک کنید.
  3. روی نصب در زیر ستون اقدامات کلیک کنید.

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

  1. برای نصب یک افزونه منتشر نشده، مستندات افزونه Google Workspace را دنبال کنید.

اکنون باید بتوانید از افزونه خود در جلسه استفاده کنید. برای امتحان کردن آن، جلسه‌ای را در meet.google.com شروع کنید. افزونه نصب شده اکنون در پنل فعالیت‌ها قابل مشاهده است.

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