Google Workspace 조직의 특정 사용자가 Google Chat 스페이스를 검색할 수 있도록 설정하기
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 Google Chat API를 사용하여 Google Workspace 조직의 특정 사용자와 Google Chat 스페이스를 공유하여 사용자가 스페이스를 검색하고 참여할 수 있도록 하는 방법을 설명합니다.
스페이스를 검색하고 참여할 수 있는 조직의 사용자를 지정하려면 공유 대상 그룹을 만듭니다. 공유 대상 그룹은 특정 부서나 전체 조직과 같이 Chat 스페이스를 공유하여 스페이스의 인지도와 공유 가능성을 높일 수 있는 사용자 그룹입니다. 타겟층을 사용하면 스페이스에 개별 사용자를 초대하지 않고도 스페이스 멤버십을 관리하고 맞춤설정할 수 있습니다. 자세한 내용은 타겟 고객 정보를 참고하세요.
공유 대상 그룹만 명명된 스페이스를 검색할 수 있습니다. 채팅 메시지나 그룹 대화와 같은 다른 스페이스 유형은 공유 대상 그룹과 공유할 수 없습니다.
기본 요건
타겟 잠재고객 ID 가져오기
타겟 잠재고객의 ID를 가져오려면 다음 단계를 따르세요.
Google 관리 콘솔에서 메뉴 menu
> 디렉터리
> 공유 대상 그룹으로 이동합니다.
공유 대상 그룹으로 이동
타겟층 표에서 타겟층의 이름 필드를 클릭합니다.
페이지 URL에서 타겟층 ID를 찾습니다. URL 형식은 https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID입니다. 여기서 TARGET_AUDIENCE_ID는 대상 그룹의 영숫자 ID입니다.
다음 섹션에서는 타겟 잠재고객 ID를 사용하여 검색 가능한 스페이스를 만들거나 기존 스페이스를 업데이트하여 타겟 잠재고객이 검색할 수 있도록 합니다.
Chat API 요청에서 공유 대상 그룹 지정
특정 타겟층을 위한 스페이스를 만들려면 Space 리소스에서 create() 또는 setup() 메서드를 사용합니다. 기존 스페이스를 검색 가능하게 만들려면 Space 리소스에서 update() 메서드를 사용합니다. 이름이 지정된 스페이스만 타겟 잠재고객과 공유할 수 있으므로 스페이스 유형(spaceType 필드에 표시됨)은 SPACE이어야 합니다.
타겟 고객이 스페이스를 검색할 수 있도록 하려면 Chat API 요청의 일부로 Space 리소스에 AccessSettings 객체를 포함하세요. 객체에서 audience 필드를 지정합니다.
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
TARGET_AUDIENCE_ID를 이전 섹션에서 가져온 타겟 잠재고객의 ID로 바꿉니다. Google Workspace 조직의 기본 Chat 스페이스 공유 설정을 사용하려면 default로 대체하세요.
Chat API를 사용하여 스페이스를 만들거나 업데이트하는 방법에 대한 자세한 내용은 다음 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-04(UTC)
[null,null,["최종 업데이트: 2025-08-04(UTC)"],[[["\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)"]]
