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 Google Chat API để chia sẻ một không gian Google 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 không gian đó.

Để 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ẻ không gian Chat để cải thiện khả năng nhận biết và 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 tham gia 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ể giúp đối tượng mục tiêu khám phá được các không gian có tên. 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 theo 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 đố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ã gồ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 có thể khám phá hoặc cập nhật một không gian hiện có để giúp đối tượng mục tiêu khám phá được không gian đó.

Chỉ định đối tượng mục tiêu và quyền chi tiết

Để tạo một không gian có các quyền truy cập cụ thể, hãy sử dụng phương thức create hoặc setup trên tài nguyên Space. Để cập nhật quyền cho một không gian hiện có, hãy sử dụng phương thức update. Vì chỉ các 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.

Để chỉ định những người có thể khám phá hoặc tham gia một không gian, hãy thêm đối tượng vào tài nguyên Space.AccessSettings Trong đối tượng này, hãy sử dụng trường accessPermissionSettings để chỉ định một hoặc nhiều quyền sau đây:

  • Có thể khám phá: Sử dụng discoverSpaceSetting để xác định những người có thể tìm thấy tên và nội dung mô tả của một không gian cũng như duyệt tìm không gian đó trong Google Chat. Bạn có thể chỉ định nhiều đối tượng mục tiêu để khám phá.
  • Có thể tham gia: Sử dụng joinSpaceSetting để xác định những người có thể tham gia một không gian mà không cần lời mời rõ ràng và xem trước tin nhắn trong không gian đó. Người dùng có thể tham gia một không gian cũng phải có thể khám phá không gian đó. Google Chat chỉ hỗ trợ một đối tượng mục tiêu cho quyền này.

Ví dụ sau đây cho thấy cách giúp hai đối tượng mục tiêu khám phá được một không gian và một trong hai đối tượng có thể tham gia không gian đó:

  "accessSettings": {
    "accessPermissionSettings": {
      "discoverSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      },
      "joinSpaceSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } }
        ]
      }
    }
  }

Thay thế TARGET_AUDIENCE_ID_1 và TARGET_AUDIENCE_ID_2 bằng mã của đối tượng mục tiêu mà bạn đã lấy trong Lấy mã đối tượng mục tiêu. Để 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.

Để tương thích ngược, hãy sử dụng trường audience

Để tương thích ngược, bạn có thể tiếp tục sử dụng trường audience để chỉ định một đối tượng mục tiêu có thể tham gia một không gian, nhưng bạn nên sử dụng phần Chỉ định đối tượng mục tiêu và quyền chi tiết.

Việc thiết lập trường audience tương đương với việc chỉ định đối tượng mục tiêu trong cả joinSpaceSetting và discoverSpaceSetting:

  "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 trong phần Lấy mã đối tượng mục tiêu. Để 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.

Tìm hiểu chế độ cài đặt quyền truy cập trong phản hồi API

Khi bạn nhận được các không gian, đối tượng AccessSettings trong phản hồi sẽ phản ánh các quyền chi tiết được thiết lập cho không gian đó.

Các trường sau đây trong AccessSettings cho biết khả năng tìm kiếm và quyền tham gia của một không gian:

  • accessState: Bắt nguồn từ quyền khám phá (discoverSpaceSetting). Nếu quyền khám phá được cấp cho một hoặc nhiều đối tượng mục tiêu, thì trường này sẽ là DISCOVERABLE. Nếu không, trường này sẽ là PRIVATE.
  • audience: Được liên kết cụ thể với quyền tham gia (joinSpaceSetting). Nếu một đối tượng mục tiêu được cấp quyền tham gia, thì trường này sẽ chứa tên tài nguyên của đối tượng mục tiêu đó.

Không gian có thể khám phá nhưng không có đối tượng tham gia

Một đối tượng mục tiêu có thể khám phá một không gian nhưng không thể tham gia trực tiếp (ví dụ: nếu người dùng phải được mời rõ ràng để tham gia).

Trong trường hợp này, đối tượng AccessSettings có các giá trị sau:

  • accessState: DISCOVERABLE
  • audience: Bị bỏ qua hoặc null

Nếu bạn thấy accessState được đặt thành DISCOVERABLE nhưng không có audience, thì điều đó có nghĩa là đối tượng mục tiêu được chỉ định trong discoverSpaceSetting có thể khám phá không gian đó, nhưng chỉ có thể tham gia bằng lời mời. Để xem những đối tượng mục tiêu có thể khám phá không gian đó, hãy kiểm tra trường accessPermissionSettings.discoverSpaceSetting.

Để biết thông tin chi tiết về đối tượng mục tiêu, hãy xem các hướng dẫn sau:

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