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 trên 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á, tham gia và xem các thành viên của không gian đó.

Để chỉ định những người dùng trong tổ chức có thể khám phá, tham gia và xem thành viên của 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 trò chuyện để kiểm soát chi tiết hơn về những người có thể truy cập vào không gian và thông tin của không gian đó. Đối tượng mục tiêu cũng giúp bạn quản lý và tuỳ chỉnh tư cách thành viên của 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ể cho phép đối tượng mục tiêu khám phá 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 nhóm, với đối tượng mục tiêu.

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

Lấy mã nhận dạng đối tượng mục tiêu

Để lấy mã nhận dạng 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ã nhận dạng đố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ã nhận dạng gồm chữ và số cho đối tượng mục tiêu của bạn.

Trong phần tiếp theo, bạn sẽ sử dụng mã nhận dạng đố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ó để đối tượng mục tiêu có thể khám phá 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ó 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ỉ 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.

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

  • Dễ tìm thấy: Sử dụng biểu tượ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 xem 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 duy nhất cho quyền này.
  • Xem tư cách thành viên: Sử dụng biểu tượng viewSpaceMembershipSetting để xác định những người có thể xem danh sách thành viên trong một không gian. Khi cập nhật những người có thể xem thông tin thành viên của không gian, bạn phải chỉ định accessSettings.accessPermissionSettings.viewSpaceMembershipSetting cùng với permissionSettings.viewSpaceMembership trong cả updateMask và nội dung yêu cầu. Khi đối tượng mục tiêu được định cấu hình trong viewSpaceMembershipSetting, bạn phải cấp viewSpaceMembership cho tất cả thành viên (managersAllowed, assistantManagersAllowed và membersAllowed được đặt thành true).

Ví dụ sau đây cho thấy cách bạn có thể giúp hai đối tượng mục tiêu khám phá được không gian, một trong hai đối tượng có thể tham gia và đảm bảo tất cả thành viên cũng như đối tượng mục tiêu được chỉ định đều có thể xem danh sách thành viên:

{
  "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" } }
        ]
      },
      "viewSpaceMembershipSetting": {
        "principals": [
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_1" } },
          { "audience": { "name": "audiences/TARGET_AUDIENCE_ID_2" } }
        ]
      }
    }
  },
  "permissionSettings": {
    "viewSpaceMembership": {
      "managersAllowed": true,
      "assistantManagersAllowed": true,
      "membersAllowed": true
    }
  }
}

Thay thế TARGET_AUDIENCE_ID_1 và TARGET_AUDIENCE_ID_2 bằng mã nhận dạng của đối tượng mục tiêu mà bạn đã nhận được trong phần Lấy mã nhận dạng đối tượng mục tiêu. Để sử dụng chế độ cài đặt chia sẻ mặc định của không gian Chat 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 duy nhất có thể tham gia một không gian, nhưng bạn nê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 joinSpaceSetting:

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

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

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

Khi bạn nhận hoặc liệt kê 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 đặt 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: Xuất phát 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 là DISCOVERABLE. Nếu không, giá trị 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 mở không có đối tượng tham gia

Đối tượng mục tiêu có thể tìm thấy 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 này 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 không gian đó bằng lời mời. Để xem những đối tượng mục tiêu nào 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 API Chat, hãy xem các hướng dẫn sau: