این صفحه نحوه استفاده از Google Chat API را برای اشتراک‌گذاری فضای گپ Google با کاربران خاص در یک سازمان Google Workspace توضیح می‌دهد تا بتوانند فضا را کشف کرده و به آن بپیوندند.
برای مشخص کردن کاربرانی که در سازمان خود می توانند فضا را کشف و به آن بپیوندند، مخاطبان هدف ایجاد می کنید. مخاطب هدف گروهی از افراد است - مانند بخش‌های خاص یا کل سازمان - که می‌توانید یک فضای چت را با آنها به اشتراک بگذارید تا آگاهی و اشتراک‌گذاری فضا را بهبود ببخشید. همچنین مخاطبان هدف به شما اجازه می‌دهند عضویت‌های فضایی را مدیریت و سفارشی‌سازی کنید تا اینکه نیازی به دعوت کاربران به یک فضا داشته باشید. برای اطلاعات بیشتر، درباره مخاطبان هدف رجوع کنید.
شما فقط می توانید فضاهای نامگذاری شده را برای مخاطبان هدف قابل کشف کنید. شما نمی توانید انواع فضای دیگر، مانند پیام های مستقیم یا مکالمات گروهی را با مخاطبان هدف به اشتراک بگذارید.
پیش نیازها
- یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat . حساب شما باید نقش سرپرست فوق العاده برای سازمان Google Workspace شما را داشته باشد.
- مخاطب هدفی که برای دسترسی در چت در دسترس است. برای ایجاد مخاطب هدف، به ایجاد مخاطب هدف مراجعه کنید. برای در دسترس قرار دادن مخاطبان هدف موجود برای فضاهای گپ، به تنظیم دسترسی به فضا برای چت مراجعه کنید.
- باید با Google Chat API با احراز هویت کاربر تماس بگیرید.
شناسه مخاطب هدف را دریافت کنید
برای دریافت شناسه مخاطب هدف، موارد زیر را انجام دهید:
در کنسول Google Admin، به منو > دایرکتوری > مخاطبان هدف بروید.
در جدول مخاطبان هدف ، روی قسمت نام مخاطبان هدف کلیک کنید.
شناسه مخاطب هدف را در URL صفحه پیدا کنید. قالب URL
https://admin.google.com/ac/targetaudiences/ TARGET_AUDIENCE_IDاست، که در آنTARGET_AUDIENCE_IDشناسه الفبایی برای مخاطبان هدف شما است.
در بخش بعدی، از شناسه مخاطب هدف برای ایجاد یک فضای قابل کشف یا به روز رسانی فضای موجود استفاده می کنید تا آن را برای مخاطب هدف قابل کشف کنید.
مخاطبان هدف را در درخواست Chat API خود مشخص کنید
برای ایجاد یک فضا برای یک مخاطب هدف خاص، از متد create() یا setup() در منبع Space استفاده کنید. برای اینکه فضای موجود قابل کشف باشد، از متد update() در منبع Space استفاده کنید. از آنجا که فقط فضاهای نامگذاری شده را می توان با مخاطبان هدف به اشتراک گذاشت، نوع فضا (که در قسمت spaceType نشان داده شده است) باید SPACE باشد.
برای اینکه فضایی را برای مخاطب هدف خود قابل کشف کنید، شی AccessSettings را به عنوان بخشی از درخواست Chat API خود در منبع Space قرار دهید. در شیء، فیلد audience را مشخص کنید:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
TARGET_AUDIENCE_ID با شناسه مخاطب هدفی که در بخش قبل به دست آوردید جایگزین کنید. برای استفاده از تنظیمات اشتراک‌گذاری فضای گپ پیش‌فرض برای سازمان Google Workspace، با default جایگزین کنید.
برای جزئیات در مورد ایجاد یا به‌روزرسانی فضاها با استفاده از Chat API، به راهنمای زیر مراجعه کنید: