یک فضای گپ Google را برای کاربران خاصی در سازمان Google Workspace قابل کشف کنید

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

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

شما فقط می‌توانید فضاهای نامگذاری شده را برای مخاطبان هدف قابل کشف کنید. نمی‌توانید انواع دیگر فضاها، مانند پیام‌های مستقیم یا مکالمات گروهی را با مخاطبان هدف به اشتراک بگذارید.

پیش‌نیازها

دریافت شناسه مخاطب هدف

برای دریافت شناسه مخاطب هدف، موارد زیر را انجام دهید:

  1. در کنسول مدیریت گوگل، به Menu > Directory > Target audience بروید.

    به مخاطبان هدف بروید

  2. در جدول مخاطبان هدف ، روی فیلد نام مخاطب هدف کلیک کنید.

  3. شناسه مخاطب هدف را در URL صفحه پیدا کنید. قالب URL به https://admin.google.com/ac/targetaudiences/ TARGET_AUDIENCE_ID است، که در آن TARGET_AUDIENCE_ID شناسه الفبایی-عددی مخاطب هدف شماست.

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

مخاطبان هدف و مجوزهای جزئی را مشخص کنید

برای ایجاد فضایی با مجوزهای دسترسی خاص، از متد create یا setup در منبع Space استفاده کنید. برای به‌روزرسانی مجوزها برای یک فضای موجود، از متد update استفاده کنید. از آنجا که فقط فضاهای نامگذاری شده می‌توانند با مخاطبان هدف به اشتراک گذاشته شوند، نوع فضا (که در فیلد spaceType نمایش داده می‌شود) باید SPACE باشد.

برای مشخص کردن اینکه چه کسی می‌تواند اعضای یک فضا را کشف، ملحق یا مشاهده کند، شیء AccessSettings را در منبع Space قرار دهید. در این شیء، از فیلد accessPermissionSettings برای مشخص کردن یک یا چند مورد از مجوزهای زیر استفاده کنید:

  • قابل کشف : از discoverSpaceSetting برای تعریف افرادی که می‌توانند نام و توضیحات یک فضا را پیدا کرده و آن را در Google Chat جستجو کنند، استفاده کنید. می‌توانید چندین مخاطب هدف را برای کشف مشخص کنید.
  • Joinable : از joinSpaceSetting برای تعریف افرادی که می‌توانند بدون دعوت صریح به یک فضا بپیوندند و پیش‌نمایش پیام فضا استفاده کنید. کاربرانی که می‌توانند به یک فضا بپیوندند، باید بتوانند آن را نیز کشف کنند. گوگل چت از یک مخاطب هدف واحد برای این مجوز پشتیبانی می‌کند.
  • عضویت مشاهده : از viewSpaceMembershipSetting برای تعریف افرادی که می‌توانند لیست اعضای یک فضا را ببینند استفاده کنید. هنگام به‌روزرسانی افرادی که می‌توانند عضویت فضا را مشاهده کنند، accessSettings.accessPermissionSettings.viewSpaceMembershipSetting باید همراه با permissionSettings.viewSpaceMembership هم در updateMask و هم در بدنه درخواست مشخص شود. هنگامی که یک مخاطب هدف در viewSpaceMembershipSetting پیکربندی می‌شود، viewSpaceMembership باید به همه اعضا اعطا شود ( managersAllowed ، assistantManagersAllowed و membersAllowed که روی true تنظیم شده‌اند).

مثال زیر نشان می‌دهد که چگونه می‌توان یک فضا را برای دو مخاطب هدف قابل کشف، و برای یکی از آنها قابل اتصال کرد، و اطمینان حاصل کرد که همه اعضا و مخاطبان هدف مشخص شده می‌توانند لیست اعضا را مشاهده کنند:

{
  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

TARGET_AUDIENCE_ID_1 و TARGET_AUDIENCE_ID_2 را با شناسه مخاطب هدفی که در بخش «دریافت شناسه مخاطب هدف» به دست آورده‌اید، جایگزین کنید. برای استفاده از تنظیمات پیش‌فرض اشتراک‌گذاری فضای چت برای سازمان Google Workspace خود، عبارت default را جایگزین کنید.

برای سازگاری با نسخه‌های قبلی، از فیلد audience استفاده کنید

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

تنظیم فیلد audience معادل تعیین مخاطب هدف در joinSpaceSetting است:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

TARGET_AUDIENCE_ID با شناسه مخاطب هدفی که در بخش «دریافت شناسه مخاطب هدف» به دست آورده‌اید، جایگزین کنید. برای استفاده از تنظیمات پیش‌فرض اشتراک‌گذاری فضای چت برای سازمان Google Workspace خود، عبارت default را جایگزین کنید.

تنظیمات دسترسی در پاسخ‌های API را درک کنید

وقتی فضاها را دریافت یا فهرست می‌کنید، شیء AccessSettings در پاسخ، مجوزهای جزئی تعیین‌شده برای فضا را منعکس می‌کند.

فیلدهای زیر در AccessSettings نشان‌دهنده‌ی قابلیت جستجو و مجوزهای اتصال یک فضا هستند:

  • accessState : از مجوزهای کشف ( discoverSpaceSetting ) گرفته شده است. اگر کشف به یک یا چند مخاطب هدف اعطا شود، این فیلد DISCOVERABLE است. در غیر این صورت، PRIVATE است.
  • audience : به طور خاص برای مجوزهای عضویت ( joinSpaceSetting ) نگاشت شده است. اگر به یک مخاطب هدف واحد مجوز عضویت اعطا شود، این فیلد شامل نام منبع آن مخاطب هدف است.

فضای قابل کشف بدون نیاز به مخاطب برای پیوستن

ممکن است مخاطب هدف بتواند فضایی را کشف کند، اما نتواند مستقیماً به آن بپیوندد (برای مثال، اگر کاربران باید صریحاً برای پیوستن دعوت شوند).

در این حالت، شیء AccessSettings دارای مقادیر زیر است:

  • accessState : DISCOVERABLE
  • audience : حذف شده یا null

اگر می‌بینید accessState روی DISCOVERABLE تنظیم شده است اما audience وجود ندارد، به این معنی است که فضا می‌تواند توسط مخاطبان هدف مشخص شده در discoverSpaceSetting کشف شود، اما فقط با دعوت می‌توان به آن پیوست. برای دیدن اینکه کدام مخاطبان هدف می‌توانند فضا را کشف کنند، فیلد accessPermissionSettings.discoverSpaceSetting را بررسی کنید.

برای جزئیات بیشتر در مورد مخاطبان هدف، به راهنماهای زیر مراجعه کنید:

برای جزئیات بیشتر در مورد ایجاد یا به‌روزرسانی فضاها با استفاده از Chat API، به راهنماهای زیر مراجعه کنید: