این صفحه نحوه استفاده از API چت گوگل برای اشتراکگذاری فضای چت گوگل با کاربران خاص در یک سازمان Google Workspace را توضیح میدهد تا آنها بتوانند این فضا را کشف کرده و به آن بپیوندند.
برای مشخص کردن کاربرانی در سازمانتان که میتوانند یک فضا را کشف و به آن بپیوندند، شما مخاطبان هدف را ایجاد میکنید. مخاطبان هدف گروهی از افراد - مانند بخشهای خاص یا کل سازمان - هستند که میتوانید یک فضای چت را با آنها به اشتراک بگذارید تا آگاهی و قابلیت اشتراکگذاری فضا را بهبود بخشید. مخاطبان هدف همچنین به شما امکان میدهند عضویت در فضا را مدیریت و سفارشی کنید، نه اینکه نیاز به دعوت تک تک کاربران به یک فضا داشته باشید. برای اطلاعات بیشتر، به «درباره مخاطبان هدف» مراجعه کنید.
شما فقط میتوانید فضاهای نامگذاری شده را برای مخاطبان هدف قابل کشف کنید. نمیتوانید انواع دیگر فضاها، مانند پیامهای مستقیم یا مکالمات گروهی را با مخاطبان هدف به اشتراک بگذارید.
پیشنیازها
- یک حساب کاربری تجاری یا سازمانی Google Workspace با دسترسی به Google Chat . حساب کاربری شما باید نقش مدیر ارشد را برای سازمان Google Workspace شما داشته باشد.
- مخاطب هدفی که برای دسترسی در چت در دسترس است. برای ایجاد مخاطب هدف، به ایجاد مخاطب هدف مراجعه کنید. برای در دسترس قرار دادن مخاطب هدف موجود در فضاهای چت، به تنظیم دسترسی به فضا برای چت مراجعه کنید.
- شما باید Google Chat API را با احراز هویت کاربر فراخوانی کنید.
دریافت شناسه مخاطب هدف
برای دریافت شناسه مخاطب هدف، موارد زیر را انجام دهید:
در کنسول مدیریت گوگل، به Menu > Directory > Target audience بروید.
در جدول مخاطبان هدف ، روی فیلد نام مخاطب هدف کلیک کنید.
شناسه مخاطب هدف را در 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برای تعریف افرادی که میتوانند بدون دعوت صریح به یک فضا بپیوندند و پیشنمایش پیام فضا استفاده کنید. کاربرانی که میتوانند به یک فضا بپیوندند، باید بتوانند آن را نیز کشف کنند. گوگل چت از یک مخاطب هدف واحد برای این مجوز پشتیبانی میکند.
مثال زیر نشان میدهد که چگونه میتوان یک فضا را برای دو مخاطب هدف قابل کشف و برای یکی از آنها قابل اتصال کرد:
"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" } }
]
}
}
}
TARGET_AUDIENCE_ID_1 و TARGET_AUDIENCE_ID_2 را با شناسه مخاطب هدفی که در بخش «دریافت شناسه مخاطب هدف» به دست آوردهاید، جایگزین کنید. برای استفاده از تنظیمات پیشفرض اشتراکگذاری فضای چت برای سازمان Google Workspace خود، عبارت default را جایگزین کنید.
برای سازگاری با نسخههای قبلی، از فیلد audience استفاده کنید
برای سازگاری با نسخههای قبلی، میتوانید همچنان از فیلد audience برای مشخص کردن یک مخاطب هدف واحد که میتواند به یک فضا بپیوندد استفاده کنید، اما توصیه میکنیم به جای آن ، مخاطبان هدف و مجوزهای جزئی را مشخص کنید .
تنظیم فیلد audience معادل مشخص کردن مخاطب هدف در هر دو joinSpaceSetting و discoverSpaceSetting است:
"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، به راهنماهای زیر مراجعه کنید: