Giúp những người dùng cụ thể trong tổ chức Google Workspace có thể tìm thấy phòng Google Chat

Trang này giải thích cách sử dụng API Google Chat để chia sẻ một phòng Chat với những người dùng cụ thể trong một tổ chức Google Workspace, để họ có thể khám phá và tham gia phòng đó.

Để chỉ định những người dùng trong tổ chức có thể khám phá và tham gia một không gian, bạn hãy tạo đối tượng mục tiêu. Đối tượng mục tiêu là một nhóm người (chẳng hạn như các phòng ban cụ thể hoặc toàn bộ tổ chức) mà bạn có thể chia sẻ một không gian Chat để cải thiện khả năng nhận biết và khả năng chia sẻ của không gian đó. Đối tượng mục tiêu cũng cho phép bạn quản lý và tuỳ chỉnh tư cách thành viên trong không gian thay vì phải mời từng người dùng vào một không gian. Để biết thêm thông tin, hãy xem bài viết Giới thiệu về đối tượng mục tiêu.

Bạn chỉ có thể đặt không gian có tên thành không gian mở cho đối tượng mục tiêu. Bạn không thể chia sẻ các loại không gian khác, chẳng hạn như tin nhắn trực tiếp hoặc cuộc trò chuyện nhóm, với đối tượng mục tiêu.

Điều kiện tiên quyết

Lấy mã đối tượng mục tiêu

Để lấy mã của một đối tượng mục tiêu, hãy làm như sau:

  1. Trong Bảng điều khiển dành cho quản trị viên của Google, hãy chuyển đến Trình đơn > Thư mục > Đối tượng mục tiêu.

    Chuyển đến Đối tượng mục tiêu

  2. Trong bảng Đối tượng mục tiêu, hãy nhấp vào trường Tên của đối tượng mục tiêu.

  3. Tìm mã đối tượng mục tiêu trong URL của trang. Định dạng URL là https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, trong đó TARGET_AUDIENCE_ID là mã chữ và số của đối tượng mục tiêu.

Trong phần tiếp theo, bạn sẽ sử dụng mã đối tượng mục tiêu để tạo một không gian mở hoặc cập nhật một không gian hiện có để đặt không gian đó thành không gian mở cho đối tượng mục tiêu.

Chỉ định đối tượng mục tiêu trong yêu cầu API Chat

Để tạo một không gian cho một đối tượng mục tiêu cụ thể, hãy sử dụng phương thức create() hoặc setup() trên tài nguyên Space. Để đặt một không gian hiện có thành không gian mở, hãy sử dụng phương thức update() trên tài nguyên Space. Vì chỉ những không gian có tên mới có thể được chia sẻ với đối tượng mục tiêu, nên loại không gian (được biểu thị trong trường spaceType) phải là SPACE.

Để đặt một không gian thành không gian mở cho đối tượng mục tiêu, hãy đưa AccessSettings đối tượng vào tài nguyên Space trong yêu cầu API Chat. Trong đối tượng, hãy chỉ định trường audience:

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

Thay thế TARGET_AUDIENCE_ID bằng mã của đối tượng mục tiêu mà bạn đã lấy được trong phần trước. Để sử dụng chế độ cài đặt chia sẻ không gian Chat mặc định cho tổ chức Google Workspace, hãy thay thế bằng default.

Để biết thông tin chi tiết về cách tạo hoặc cập nhật không gian bằng API Chat, hãy xem các hướng dẫn sau: