یک فضای گپ Google را برای کاربران خاصی در سازمان Google Workspace قابل کشف کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه نحوه استفاده از Google Chat API را برای اشتراک‌گذاری فضای گپ Google با کاربران خاص در یک سازمان Google Workspace توضیح می‌دهد تا بتوانند فضا را کشف کرده و به آن بپیوندند.
برای مشخص کردن کاربرانی که در سازمان خود می توانند فضا را کشف و به آن بپیوندند، مخاطبان هدف ایجاد می کنید. مخاطب هدف گروهی از افراد است - مانند بخش‌های خاص یا کل سازمان - که می‌توانید یک فضای چت را با آنها به اشتراک بگذارید تا آگاهی و اشتراک‌گذاری فضا را بهبود ببخشید. همچنین مخاطبان هدف به شما اجازه می‌دهند عضویت‌های فضایی را مدیریت و سفارشی‌سازی کنید تا اینکه نیازی به دعوت کاربران به یک فضا داشته باشید. برای اطلاعات بیشتر، درباره مخاطبان هدف رجوع کنید.
شما فقط می توانید فضاهای نامگذاری شده را برای مخاطبان هدف قابل کشف کنید. شما نمی توانید انواع فضای دیگر، مانند پیام های مستقیم یا مکالمات گروهی را با مخاطبان هدف به اشتراک بگذارید.
پیش نیازها
شناسه مخاطب هدف را دریافت کنید
برای دریافت شناسه مخاطب هدف، موارد زیر را انجام دهید:
در کنسول Google Admin، به menu > دایرکتوری > مخاطبان هدف بروید.
به مخاطبان هدف بروید
در جدول مخاطبان هدف ، روی قسمت نام مخاطبان هدف کلیک کنید.
شناسه مخاطب هدف را در 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، به راهنمای زیر مراجعه کنید:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page guides Google Workspace admins on how to use the Google Chat API to share named spaces with specific users within their organization.\u003c/p\u003e\n"],["\u003cp\u003eTarget audiences are used to control which users can discover and join a space, replacing the need to invite individuals.\u003c/p\u003e\n"],["\u003cp\u003eTo share a space, the \u003ccode\u003eAccessSettings\u003c/code\u003e object in the Chat API request should contain the target audience ID within the \u003ccode\u003eaudience\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003ePrerequisites include a Business or Enterprise Google Workspace account with super admin privileges, an available target audience, and user authentication when calling the Chat API.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can get the target audience ID from the Google Admin console under Directory > Target Audiences, then locate it within the URL of the specific target audience page.\u003c/p\u003e\n"]]],["The core content details sharing Google Chat spaces with specific users within a Google Workspace organization using the Google Chat API. It focuses on creating or updating spaces to be discoverable to target audiences—groups of users like departments or the entire organization. To achieve this, users must obtain a target audience ID from the Google Admin console and include it in the API request's `AccessSettings` object when creating or updating a named space. This makes the space discoverable and allows customized memberships.\n"],null,["# Make a Google Chat space discoverable to specific users in a Google Workspace organization\n\nThis page explains how to use the Google Chat API to share a Google Chat space\nwith specific users in a Google Workspace organization, so that they can\ndiscover and join the space.\n\nTo specify the users in your organization that can discover and join a space,\nyou create target audiences. A *target audience* is a group of people---such as\nspecific departments or the entire organization---that you can share a\nChat space with, to improve the space's awareness and\nshareability. Target audiences also let you manage and customize space\nmemberships rather than needing to invite individual users to a space. For more\ninformation, see [About target\naudiences](https://support.google.com/a/answer/9934697).\n\nYou can only make named spaces discoverable to target audiences. You can't\nshare other space types, such as direct messages or group conversations, with\ntarget audiences.\n\nPrerequisites\n-------------\n\n- A Business or Enterprise [Google Workspace](https://support.google.com/a/answer/6043576) account with access to [Google Chat](https://workspace.google.com/products/chat/). Your account must have the [super administrator\n role](https://support.google.com/a/answer/2405986?sjid=1448018578843125834-NC#super_admin) for your Google Workspace organization.\n- A target audience that's available for access in Chat. To create a target audience, see [Create a target\n audience](https://support.google.com/a/answer/9935192). To make an existing target audience available to Chat spaces, see [Set up space access for Chat](https://support.google.com/a/answer/12129901).\n- You must call Google Chat API, with [user authentication](/workspace/chat/authenticate-authorize-chat-user).\n\nGet the target audience ID\n--------------------------\n\nTo get the ID of a target audience, do the following:\n\n1. In the Google Admin console, go to\n **Menu menu\n \\\u003e Directory\n \\\u003e Target audiences**.\n\n [Go to Target audiences](https://admin.google.com/ac/targetaudiences)\n2. In the **Target audiences** table, click the **Name** field of the target\n audience.\n\n3. Find the target audience ID in the URL for the page. The URL format is\n `https://admin.google.com/ac/targetaudiences/`\u003cvar translate=\"no\"\u003eTARGET_AUDIENCE_ID\u003c/var\u003e,\n where \u003cvar translate=\"no\"\u003eTARGET_AUDIENCE_ID\u003c/var\u003e is the alphanumeric ID for\n your target audience.\n\nIn the next section, you use the target audience ID to either create a\ndiscoverable space or update an existing space to make it discoverable to the\ntarget audience.\n\nSpecify the target audience in your Chat API request\n----------------------------------------------------\n\nTo create a space for a specific target audience, use the [`create()`](/workspace/chat/api/reference/rest/v1/spaces/create) or\n[`setup()`](/workspace/chat/api/reference/rest/v1/spaces/setup) method on the `Space` resource. To make an existing space\ndiscoverable, use the [`update()`](/workspace/chat/api/reference/rest/v1/spaces/patch) method on the `Space` resource. Because only\nnamed spaces can be shared with target audiences, the space type\n(represented in the `spaceType` field) must be `SPACE`.\n\nTo make a space discoverable to your target audience, include the\n[`AccessSettings`](/workspace/chat/api/reference/rest/v1/spaces#accesssettings)\nobject in the `Space` resource as part of your Chat API request. In\nthe object, specify `audience` field: \n\n \"accessSettings\": {\n \"audience\": \"audiences/\u003cvar translate=\"no\"\u003eTARGET_AUDIENCE_ID\u003c/var\u003e\"\n }\n\nReplace \u003cvar translate=\"no\"\u003eTARGET_AUDIENCE_ID\u003c/var\u003e with the ID of the target\naudience that you obtained in the previous section. To use the default\nChat space share settings for your Google Workspace\norganization, replace with `default`.\n\nFor details on creating or updating spaces using the Chat API, see the\nfollowing guides:\n\n- [Create a space](/workspace/chat/create-spaces)\n- [Set up a space](/workspace/chat/set-up-spaces)\n- [Update a space](/workspace/chat/update-spaces)\n\nRelated topics\n--------------\n\n- [Create a target audience](https://support.google.com/a/answer/9935192)\n- [Set up sharing in Chat](https://support.google.com/a/answer/12129901)\n- [Create spaces with different access levels](https://support.google.com/chat/answer/11971020)"]]
