این صفحه نحوه استفاده از 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شناسه الفبایی-عددی مخاطب هدف شماست.
در بخش بعدی، شما از شناسه مخاطب هدف برای ایجاد یک فضای قابل کشف یا بهروزرسانی یک فضای موجود برای قابل کشف کردن آن برای مخاطب هدف استفاده میکنید.
مخاطب هدف را در درخواست 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، به راهنماهای زیر مراجعه کنید: